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1. INTRODUCTION 


GENERAL 


This manual describes the Data Management facilities provided in the UNIVAC OS/4 
Operating System. It includes descriptions of the file conventions accepted by Data 
Management and the macro instructions used in sequential and nonsequential methods 

of accessing files. A knowledge of the UNIVAC OS/4 Job Control Programmer Reference, 
UP-7793 (current version) and UNIVAC 9400 System Assembler/Central Processor Unit 
Programmer Reference, UP-7600 (current version), is helpful in using this manual. 


Data Management is part of the software that provides a convenient interface between 
problem programs and the hardware-oriented I/O portions of the Supervisor. Data 
Management facilities provide organizational benefits such as record blocking and 
deblocking, buffering, data validation, and label processing. 


Data Management facilities consist of logical Input/Output Control System (IOCS) 
modules, transient routines, and declarative and imperative macro instructions, The 
logical IOCS modules consist of re-entrant common code subroutines. The transient 
routines provide functions which are infrequently used and therefore do not need to 
be available during the complete file processing. A macro instruction is similar in 
form to a source code instruction; it may have a label, but it must have an operation 
code and an operand field containing one or more parameters. 


The parameters used with the declarative macro instructions describe all aspects of 
the file to be processed, whereas the parameters used with the imperative macro 
instructions point to the file described by a declarative macro and sometimes add 
additional details specifying processing action to be taken. 
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Logical IOCS Modules 


Logical IOCS modules consist of re-entrant common code subroutines that can 
become part of the operating system, can be linked into the problem program, ora 
combination of both. 


At system generation time the user can select those logical modules or parts of 
modules that are needed to process the files that are used most often. The result 
is a saving in storage space since a subroutine can be shared by all files rather 
than repeating file processor coding in each problem program that is loaded. Any 
module so chosen becomes a part of the operating environment and is replaced in 
this form in the systems library by abbreviated modules that contain only special 
symbol definitions. Thus, references to these modules within a problem program 
produce a special output rather than the entire module. This enables logical IOCS 
to establish linkage to the code chosen as part of the operating system. This option 
is particularly beneficial when the user is operating in a multiprogramming environ- 
ment. 


Any module that is not chosen at system generation time to become part of the 
operating system can remain as part of the system library. When logical IOCS 
references these modules, the code for the entire module is linked directly into 

the problem program. The modules are then shared among the files within the problem 
program. This option is particularly beneficial when the user is operating in a single 
program environment. 


Declarative Macro Instructions 


A problem program must inform the system of the parameters, special conditions, 
current status and options pertaining to a file. This is accomplished by including 

a declarative (file definition) macro instruction for each file required by the problem 
program. As implied by the term declarative, these macro instructions generate 
nonexecutable code, such as constants and storage areas for variables. Therefore, 
these macro instructions should be separated from the inline file processing coding. 
The declarative macro instruction and the selected keyword parameters in the operand 
define the file. The first three characters of the operation code must be DTF, meaning 
Define The File. The last two characters usually indicate the type of device or 
method of accessing. A keyword parameter consists of a word or code immediately 
followed by an equals (=) sign which is in turn followed by one specification. 


The format of the declarative macro instruction is: 


B OPERATION 5 OPERAND 






filename keyword-1l=x,keyword-2=y,...,keyword-n=z 
The symbolic name of the file must appear in the label field. It can have a maximum 
of seven characters and must begin with an alphabetic character. The appropriate 
DTF designation must appear in the operation field. The keyword parameters can 

be written in any order in the operand field and must be separated by commas. Appro- 
priate assembler rules regarding macro instructions apply to blank columns and 
continuation statements. Register numbers are specified to the Data Management 
declarative macro instructions (DTF’s) by enclosing the number in parentheses. 
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Imperative Macro Instructions 


A problem program must be able to communicate with logical IOCS in order to 
accomplish the processing of files that have been defined by declarative macro 
instructions. This is accomplished by including imperative (file processing) macro 
instructions in the problem program, which in turn communicate with the transient 
routines and modules of logical IOCS coding. The imperative macro instructions are 


expanded as inline executable code. Not all macro instructions are available for use 
on all devices. Some are specifically input type macro instructions and cannot be used 


for a device that is exclusively used for output; the opposite is true, also. 
The format of the imperative macro instruction is: 


LABEL B OPERATION 5 OPERAND 
[name] XXXX VVVV 000, ZZ2Z 


A symbolic name can appear in the label field. It can have a maximum of eight 
characters and must begin with an alphabetic character. The appropriate verb 

or code must appear in the operation field. The positional parameters (as signi- 
fied by the name) must be written in the specified order in the operand field and 
be separated by commas. When a positional parameter is omitted, the comma must 
be retained to indicate the omission except in the case of omitted trailing param- 
eters. Appropriate assembler rules regarding macro instructions apply to blank 
columns and continuation statements. 


1.2. STATEMENT CONVENTIONS 


The conventions used to illustrate statements in the manual are as follows: 


Capital letters and punctuation marks (except braces, brackets, and ellipses) are 
information that must be coded exactly as shown; 


Lowercase letters and terms represent information that must be supplied by the 
program mer; 


Information contained within braces { } represents necessary entries of which one 
must be chosen; 


Information contained within brackets represents optional entries that (depending 
on program requirements) are included or omitted. Braces within brackets signify 
that one of the entries must be chosen if that operand is included. 


An ellipsis (a series of three periods) indicates the presence of a variable number of 
entries. 


Commas are required after each parameter except after the last parameter specified. 
When a positional parameter is omitted from within a series of parameters, the comma 
must be retained to indicate the omission. 
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1.3. SPECIAL REGISTER NOTATION 


The user can preload parameter registers 0 and/or 1 prior to executing an imperative 
macro instruction. When the register option is selected, the actual designations (0) 
and/or (1) are coded signifying that the register(s) are loaded with the necessary 
parameter(s) as specified by logical IOCS. This is known as special register notation. 


1.4. DATA MANAGEMENT REGISTER CONVENTIONS 


Logical IOCS assumes that registers 0 and 1 are volatile. These two registers usually 
contain positional parameters. Register 13 is assumed to have been preloaded by the 
user with the address of a 72-byte save area (aligned on a full word boundary), and 

it is used to access that area. Registers 14 and 15 are considered volatile and avail- 
able for use by logical IOCS. For macro instructions that do not generate a call to a 
transient routine, register 14 is used to transfer control to the user following an im- 
perative macro instruction, while register 15 is used to pass control from the macro 
instruction to the processing modules. For macro instructions that do generate a 
transient call, the contents of registers 14 and 15 are preserved by the transient 
scheduler. 
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1.5. 


1.5.1. 





DATA MANAGEMENT DUMMY CONTROL SECTION 


A special macro instruction (DTFD) is used to generate a dummy control section 
which can be shared by any or all of the logical IOCS modules included in the user’s 
system. The dummy control section (DSECT) permits the user to define symbolic 


addresses without any associated storage allocation; that is, it allows the mapping 
or remapping of a storage area already defined within the module or elsewhere with- 


out any additional allocation of space. Displacement and base relative addresses 


are calculated by the assembler for each symbol defined by the DSECT, but they do 


not become part of the object program. 


Only the unprotected portions of the DTF’s are affected by the DTFD macro call. 
Keyword parameters associated with this instruction permit the user to specify any 
or all of the DTF expansions he wants covered by the generated dummy control 
section. The resulting DSECT code will consist of a common section (common to 


all DTF’s), 


followed by individual sections that correspond to the number of para- 


meters selected in the DTFD macro instruction. The DTFD macro may be called 
several times within a program with the assurance that no symbol will be generated 


more than 


once. 


NOTE: In order to provide for I/O storage protection, certain critical portions of 


each DTF macro instruction are separated from the rest of the program unit 
and placed in a protected area. When a DTF routine forms an address to be 
used in an input operation, for example, it checks that the operation refers 


PAGE: 


only to those storage locations allocated to the routine and does not violate 
the I/O protect area. 


Instruction Format 


The DTFD macro instruction contains a maximum of six optional keyword 
parameters. The instruction format is: 


LABEL 


unused 


NOTE: 


where: 


Bb OPERATION 6 OPERAND 


[MT=YES] 
[SD=YES] 
[CD=YES] 
[PR=YES] 
[PT=YES] 

[OR=YES] 
[DA=YES] 
[IS=YES] 





Assembler rules concerning commas and continuation of parameters in 
operand field apply when writing this macro instruction; see 1.2. 


MT provides a map of the unprotected DTF storage area generated by a 
call to DTFMT (magnetic tape file). 


SD provides a map of the unprotected DTF storage area generated by a 
call to DT FSD (sequential device file). 


CD provides a map of the unprotected DTF storage area generated by a 
call to DTFCD (card device file), 


PR provides a map of the unprotected DTF storage area generated by a 
call to DTFPR (printer file). 
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PT provides a map of the unprotected DTF storage area generated by a ~ 
call to DTFPT (paper tape file). 


OR provides a map of the unprotected DTF storage area generated by a 
call to DTFOR (optical document reader). 


DA provides a map of the unprotected DTF storage area generated by a 
call to DTFDA (direct access file). 


IS provides a map of the unprotected DTF storage area generated by a 
call to DIFIS (indexed sequential file). 


NOTES: If no parameters are specified in the operand field, a DSECT that includes 
all options will be generated. 


This macro instruction may be used to request mapping of more than one 
type of DTF; if so, operands must be separated by commas. 


The format of the generated DSECT includes a common unprotected 
section (containing labels of the form DC$xxx) which is common to 
all DTF types, and which is concluded by the definition of an overlay 
point (DC$OVL). Following the overlay point, any additional sections 
are generated according to the DTF’s requested in the DTFD operand 
field. 


1.5.2. DSECT Usage 


In order to reference standard symbols within the DSECT, the user must supply a ‘nf 
USING statement referencing label DC$SCT (the DSECT starting point). The 

register specified in the USING statement must be the register containing the 

address of the DTF macro instruction to be manipulated. 


For example: 
USING DC$SCT,2 


This specifies that all DSECT-generated symbols would be covered by register 2. 


Prior to use of the DSECT symbols, register 2 must be loaded with the address of 
the required DTF macro instruction; that is, 


L 2,=A(filename) 


where filename is the symbol appearing in the label field of the actual DTF.. 
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2. FILE CONVENTIONS 
2.1. GENERAL 
A set of conventions has been adopted to facilitate the handling, locating, and 
Nw 


processing of data files by the UNIVAC OS/4 Operating System (OS/4) Data Manage- 
ment System. The form of the files may vary somewhat from one device type to 
another, yet there are large areas where their conventions overlap. In the section 
that follows, explicit formats show these conventions (which are compatible within 
the industry). 


As a means of identification, files are assumed to have labels in a standard format. 
Files may be combined to span a volume. A volume is a reel of tape or a disc pack 
cartridge. Every volume in a system can be numbered and have a volume label recorded 
on it. On direct access storage devices, files may be divided into extents. An extent 
is any contiguous space on the device. Therefore, files may consist of one extent, or, 
if the file is fragmented, it may consist of several extents. On direct access storage 
devices, files may be stored in any available area on the device and an index to the 
various fragments of the file is maintained. This index or directory is called the 
volume table of contents and is provided to record the allocation of space for the 

files on the volume. 
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2.2. MAGNETIC TAPE CONVENTIONS 


Magnetic tapes may or may not be labeled and a labeled tape may have either standard 
or nonstandard labels. The Data Management System assumes tapes have standard 
labels but permits other label conventions. Tape volumes have formats which may be 
specified as standard, nonstandard, or unlabeled. Record types and the form for check- 
point blocks are also specified. The following paragraphs describe the magnetic tape 
conventions handled by the UNIVAC OS/4 Data Management System. 


2.2.1. Standard Tape Labels 


All standard tape labels are in blocks of 80 bytes. Tape labels are always recorded 
at the same density as the data. There are five types of tape label groups (three 
are required and two are optional): 


m Volume label group 

a File header group 

@ User header group (optional) 
m File trailer group 


gw User trailer group (optional) 


2.2.1.1. Volume Label Group 


A volume label group is composed of an initial volume label (VOL1) followed by 
up to seven volume labels (VOL2 ... VOL8). The VOL1 label identifies the tape 
reel and its owner and is used to check that the proper reel is mounted. When a a 
tape is first used at an installation, the serial number and other volume informa- 
tion as shown in Figure 2—1 are specified by parameter cards supplied to a 
standard utility routine which writes the label. The serial number is also written 
on the exterior of the reel for visual identification. 


At job preparation time, the serial number of the volume to be used may be supplied 
to the Job Control program along with other parameters, If supplied, the Job Control 
program checks the serial number from the VOL1 label to ensure that the proper 

reel is mounted for input or output. The tape is then rewound without interlock. 

See UNIVAC OS/4 Job Control Programmer Reference, UP-7793 (current version). 


When an OPEN macro instruction is issued for an output tape, the VOL1 label is 
read and the serial number is saved for use in the file header labels. The tape is 
positioned so that the volume labels are not destroyed and no further processing 
is performed. : 


When an OPEN macro instruction is issued for an input tape, the volume serial 
number equal to that in the VOL1 label is used to check the file serial number in 
the file header label. The tape is positioned past the last volume label and no 
further volume label processing is performed. 


When any volume label is encountered during the processing of a CLOSE macro 
instruction for an input tape, and the READ parameter is set to BACK, the label 


is simply bypassed without processing. 


The formats of the volume labels are shown in Figures 2—1 and 2-2. 
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a Bytes 


m Byte l 
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0-2 


4-9 


0 


11-20 
21-30 
31-40 
41-50 


51-79 





Code 





EBCDIC 


EBCDIC 
EBCDIC 


EBCDIC 


EBCDIC 
EBCDIC 
EBCDIC 


EBCDIC 


EBCDIC 
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SECTION: 


VOLUME SERIAL NUMBER 


VOLUN 
SECURITY 


OWNER IDENTIFICATION 


RESERVED 


Figure 2-1. Tape Volume 1 Label Format 


Label Identifier — Contains VOL to indicate that this is a 
volume label. 


Label Number — Always 1, for the initial volume label. 


Volume Serial Number — Unique identification assigned to a 
reel when it enters the system. This number also appears on 
the outside of the reel. It is usually numeric but may be any 
six alphanumeric characters. 


Volume Security — Reserved for future use by installations 
requiring security at the reel level; this is currently blank. 


Reserved — Contains blanks. 
Reserved — Contains blanks. 
Reserved — Contains blanks. 


Owner Identification — Unique identification of the owner of 
the reel. It may be any combination of alphanumeric characters. 


Reserved — Contains blanks. 
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wee 
f USER SUPPLIED 








Figure 2—2, Additional Volume Labels Format 


Field Code 
ms Bytes 0-2 EBCDIC Label Identifier — contains VOL to indicate a volume label. 


ws Byte 3 EBCDIC Label Number — 2 through 8, indicating the position of the 
volume label within the group. 


@ Bytes 4-79 EBCDIC User supplied. 


File Header Label Group 


A file header label, HDR1, is written at the beginning of each file. This label 
is required and has a fixed format. The HDR1 label identifies the file. The format 
is shown in Figure 2-3. 


On an input file, all fields up to and including the creation date in the HDR1 
label are checked against values specified in the LBL Job Control statement. 
Only those fields for which values have been supplied are checked; however, 
when the READ parameter is set to BACK, the HDR1 label is bypassed without 
processing. 


For an output file, the expiration date in the HDR1 label is checked against the 
current or actual calendar date to determine if the associated file has expired. 
If it has expired, the tape is positioned so that the old HDR1 label is written 
over. The new HDR1 block is set up from values specified by the LBL Job ‘ 
Control statement and is written on the tape. All of the fields in the HDR1 label 
may be supplied in the job stream. See the LBL statement described in UNIVAC 
OS/4 Job Control Programmer Reference, UP-7793 (current version), and 
Appendix A.1 in this manual. 


The user also has the option of using HDR2 ... HDR8 labels, which are reserved 
for compatibility with other systems. However, Data Management does not create 
these labels for output files, but the user may write them on output or check them 
on input in a user label routine. 
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Field Code 
Bytes 0-2 EBCDIC 
Byte 3 EBCDIC 


Bytes 4—20 EBCDIC 


Bytes 21-26 EBCDIC 


Bytes 27-30 EBCDIC 


Bytes 31-34 EBCDIC 


w Bytes 35-38 EBCDIC 
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FILE SERIAL NUMBER 
VOLUME... 


. SEQUENCE NUMBER 


. SEQUENCE NUMBER Scene eN 





-.. NUMBER VERSION... 
CREATION DATE 


EXPIRATION DATE 


SECURITY 


Figure 2~3. Header ] Label Format 


Label Identifier ~ Contains HDR to indicate a file header label. 
Label Number — Always 1. 


File Identifier — A 17-byte configuration that uniquely identifies 
the file. It may not contain embedded blanks and is left justified 
in the field if less than 17 bytes are specified. 


File Serial Number — The serial number of the VOL1 label for 
the first reel of a file or a group of multifile reels. 


Volume Sequence Number — The position of the current reel with 
respect to the first reel on which the file begins. This is used 
with multireel files. 


File Sequence Number — The position of this file with respect 
to the first file in the group. 


Generation Number — The generation number of the file 
(0000-9999). 
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Field Code 


Bytes 39-40 EBCDIC 


Bytes 41-46 EBCDIC 


Bytes 47-52 EBCDIC 


Byte 53 EBCDIC 


Bytes 54-59 EBCDIC 


Bytes 60-72 EBCDIC 


Bytes 73-79 EBCDIC 


User Header Label Group 






2 
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Version Number of Generation — The version number of a partic- 
ular generation of the file. 


Creation Date — The date on which the file was created. The 
date is expressed in the form yyddd and is right justified. The 
leftmost position is a blank. 


Expiration Date — The date on which the file may be written 
over or used as scratch. The date is in the same form as the 
creation date. 


Reserved for File Security Indicator — This byte indicates 
whether additional qualifications must be met before a problem 
program can have access to the file. 


0 = No additional qualifications are required. 


1 = Additional qualifications are required. 


Unused — Contains zeros. 


Reserved for System Code — The unique identification of the 
operating system that produced the file. 


Reserved — Contains blanks. 


Up to eight user header labels can follow the file header label group. For output 
files, the labels are written by Data Management as directed by the problem program 
recording the file. 


When the file is retrieved, the user header label group is made available to the 
problem program for processing. Conventions describing this procedure can be 
found in the description of the OPEN and LBRET macro instructions (see 3.3.1 
and 3.3.7, respectively). The format of the user header label is shown in Figure 


Da 


4. 





76 


USER SUPPLIED 


Figure 2-4, User Header Label Format 
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Field Code 


m Bytes 0—2 EBCDIC Label Identifier — Contains UHL to indicate a user header label. 


m Byte 3 EBCDIC Label Number — This field gives the relative position (1 to 8) 


of the label within the group. 


m Bytes 4-79 EBCDIC User supplied. 


File Trailer Label Group 


The file trailer label group consists of either of two labels written in a format 
identical to the file header labels, shown in Figure 2~3, except for the following 
fields: 


m Bytes 0-2 EBCDIC Label Identifier — The contents indicate that this is a file 
trailer label and may be either EOF for an end-of-file label 


or EOV for an end-of-volume label. 


a Byte 3 EBCDIC Label Number — Indicates whether the label is the first or second 


(optional) file trailer label. 


m Bytes 54-59 EBCDIC Block Count — In the first file trailer label, this field indicates 
the number of data blocks either in the file of a multifile reel 
or on the current reel of a multireel file. Logical IOCS checks 
the block count for input files, and writes the count for output 


files. 


When an OPEN macro instruction is issued on an input file with READ = BACK 
specified, the fields in an EOF1 label are checked against values specified in the 
LBL Job Control statement. This is similar to processing of the HDR1 label 

as described in 2.2.1.2. 


2.2.1.5. User Trailer Label Group 


2.2.2, 


Up to eight user trailer labels may follow the file trailer label group. User trailer 
labels are processed in the same manner as user header labels. They have the 
same format as well, except that the first field contains UTL instead of UHL. 
Figure 2—4 and the notes which follow also illustrate and describe the format of 
the user trailer label. 


Reel and File Organization 


The macro instruction that defines the file for magnetic tapes must specify whether 
the tape volumes are standard, nonstandard, or unlabeled. The following three sub- 
sections describe the organization of and requirements for files and reels with - 
respect to these three conventions. 


2.2.2.1. Standard Tape Volume Organization 


A standard volume has standard labels, requires tape marks, and is capable of 
being processed by logical IOCS. Figure 2—5 illustrates the reel organization for 
a standard volume with either an end-of-file or end-of-volume condition. Logical 
IOCS assumes that the labels appear in the order shown. The labels that are 
shaded are optional. Any optional header or trailer labels must be processed by 
the user’s special label handling routine. If the user does not specify such a 
routine, the optional labels are simply bypassed. 
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On input operations, the additional volume labels are not checked by logical IOCS. 
If any exist, they are bypassed. On output operations, no provision is made in 
logical IOCS for the user to write additional volume labels. Logical IOCS also 

has no provisions for handling a multifile reel or a group of associated multireel 
files. 


A volume processed by logical IOCS will have either an end-of-file label or an 
end-of-volume label followed by two tape marks. The second tape mark signifies 
that no valid information follows. 


WITH END-OF-FILE CONDITION WITH END-OF-VOLUME CONDITION 


VOL 1 LABEL 





VOL 1 LABEL 
L 













HDR1 LABEL 
ui 


TAPE MARK 


TAPE MARK 


DATA 
BLOCKS 


TAPE MARK 
EOV1 LABEL 
ABELS | 





DATA tal 
BLOCKS 





TAPE MARK 


FOF] LABEL 









TAPE MARK 


TAPE MARK 
TAPE MARK 


oO Required Labels 
Optional Labets 


TAPE MARK 








Figure 2-5. Reel Organization for a Standard Volume 
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2.2.2.2. Nonstandard Volume Organization 


A nonstandard volume is any volume that has nonstandard labels and is capable 
of being processed by logical IOCS. The reel organization for a nonstandard volume 
is shown in Figure 2-6. 


The address of a user’s label handling routine to process nonstandard labels is 
usually specified; in which case the tape mark following the header labels may 
be omitted. If nonstandard header labels appear on an input file but are not to be 
checked when the file is read, the address of the user’s label handling routine is 
omitted. In this case, the tape mark must appear. 


The header and trailer labels are optional and may be of any format length and 
number since they are handled by the user’s label routine. The tape mark following 
the header label is required only if label checking is omitted or a read backward 
operation is specified. The tape marks following the data blocks and the trailer 
label are required and are written by logical IOCS. The second tape mark following 
the trailer label is written if the tape is to be rewound with or without interlock 

on output operations. 


DATA 
BLOCKS 


TAPE MARK 


TAPE MARK 





CJ Required Labels 
Optional Labels 


Figure 2~6. Reel Organization for a Nonstandard Volume 
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2.2.2.3. Unlabeled Volume Organization 


An unlabeled volume is any volume capable of being processed by logical IOCS. 

The fact that the volume has no labels and may or may not have a tape mark preceding 
the data blocks must be specified in the declarative macro instruction. The reel 
organization for a volume with no labels is illustrated in Figure 2—7. It should be 
noted that on read backward operations, the tape mark preceding the data blocks 

must be present. 


The tape mark following the data blocks is required and is supplied by logical 
IOCS on output operations. An additional tape mark is written if the tape is to be 
rewound with or without interlock on output operations. 


BLOCKS 





O Required Labels 
CJ Optional Labels 


Figure 2-7. Reel Organization of a Volume Without Labels 


2.2.3. Checkpoint Blocks 


The first and last blocks of a checkpoint dump begin with the following configuration: 


a al bbb///BCHKPT6B//xxyynnnn 
where: 
—_> bbb is an optional block number. 
6 represents a blank. 
—_> XX is a two-byte binary count of storage dump records between the header and 


the trailer records. 


—_>- yy is the two-byte total number of words following the header unpacked 
decimal counter. 


nnnn is the checkpoint number assigned. 
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2.2.4. 


Checkpoint blocks are bypassed by logical IOCS on input operations when the 
proper keyword parameter is specified in the macro instruction defining the file. 


Checkpoint blocks are not reflected by the total in the block count field in either 
the EOF 1 or the EOV1 standard trailer labels. 


Record Formats 


Records within a file may be grouped into blocks when more than one logical record 
equals a physical record. Records may be unblocked if only one logical record equals 
a physical record. 


The format of individual records may be fixed length, variable length, or undefined. 
If the record format is undefined, the records are also assumed to be unblocked and 
any deblocking must be supplied by the user. 


2.2.4.1. Fixed-Length Records 





Fixed-Length, Blocked Records 


If the size of a record in a file is a fixed length, the size of a block is usually a 
fixed length. The block size is always an integral multiple of the record size. A 
TRUNC macro instruction may cause a short block to be written; the block written 
is still a multiple of the record size. An illustration of fixed-length records is given 
in Figure 2—8. 





Record n Record n+l Record n+2 


Fixed-Length, Unblocked Records 


Record n : Record n+l 








LEGEND: 


IRG — Interrecord gap 


n = Any data record in the file 


b — Block size 


Figure 2~8. Magnetic Tape Fixed-Length Records 
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2.2.4.2. Variable-Length Records 











ae 
Files with variable-length records may have either blocked or unblocked records. 
The length of the block must be specified and must precede the record or records 
in the block. The number of bytes in a variable-length record must be specified 
and must precede the data in the record. Figure 2—9 illustrates the format of 
both blocked and unblocked records. 
Variable-Length, Unblocked Records 
Peep mee 
| SSS SSS Ss 
| > 
Variable-Length, Blocked Records 





J 4 


| 4] | "2 43 


» 





LEGEND: 
b ~— Block length (two bytes) 
a  — Record length (two bytes) 
X  — Reserved for system use (two bytes) 
d — Data field in the record 


IRG — Interrecord gap 


Figure 2~9, Magnetic Tape Variable-Length Records 
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2.2.5. Processing 7-Track Tape with the Data Conversion Feature 


When the data conversion feature is being used for writing, three 8-bit data bytes 
are converted to four 6-bit tape characters, Conversion is accomplished in multiples 
of three data bytes. If the last group contains less than three data bytes, the 

group is zero filled by the hardware to make up the equivalent of three bytes. In 
effect, the hardware always writes blocks in multiples of three. 


Only those tapes which have been converted to four 6-bit tape characters can be 
read by the data conversion feature. Tapes must be written in a format that will 
enable them to be read. These are the only restrictions imposed on writing tape. 
When reading tape, Data Management compares the specified block size with the 
number of bytes actually read in. If the hardware has added any bytes to make 
the block size a multiple of 3, Data Management will detect a block size error 
and either cancel the job or exit to a user-supplied error routine. This can be 
avoided by ensuring that each block written is a multiple of 3. 


For reading tape forward, the following precautions should be taken: 
: If the record format is fixed unblocked, the block size must be a multiple of 3. 
a If the record format is fixed blocked, the record size must be a multiple of 3. 


L If the record format is variable unblocked or blocked, the total block length 
must be a multiple of 3. For unblocked records, this block length is equal 
to the length of the data field, plus 8. For blocked records, this block length 

: is equal to the sum of the length of the data fields, plus 4 times the number 
— of records, plus 4 (Figure 2—9). 


L If the record format is undefined, there are no restrictions. The user is 
cautioned, however, that if the block length is not a multiple of 3, the 
last one or two bytes will contain 0’s, and these bytes will be counted in 
the record length passed to the user by Data Management. 


For reading tape backward, the same restrictions apply. In addition, if the 
record format is undefined, each block must be a multiple of 3. 
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DIRECT ACCESS STORAGE DEVICE CONVENTIONS 


Conventions for files on the direct access storage subsystem are similar to those 
for files on magnetic tapes. However, there are some differences. 


The method of addressing volumes, files, and records on the disc uses a combina- 

tion of the logical unit number of the device (n = 1—8), the cylinder number 

(cc = 0—202 for the UNIVAC 8411 and 8414 Disc Subsystems, or ce = 0—405 

for the UNIVAC 8424 Disc Subsystem), the read/write head number (hh = 0-9 

for the UNIVAC 8411 Disc Subsystem, or hh = 0—19 for the UNIVAC 8414 

and 8424 Disc Subsystems), and the sequential number of the record (r) on the 

track. The value of the record number may range from 0 through 255; however, track 
capacity is considerably less depending on the size of the records. The last three 
cylinders of a volume are reserved for alternate tracks. (In the address of a disc record, 
the value 00 is supplied for Bb.) 


Because the files within a volume may be stored in various locations on a disc, a 
directory listing the addresses of the fragments of the files is required. This directory 
is called the volume table of contents. The volume table of contents and files within 
a volume on a disc require various standard labels in predefined formats to describe 
the files. 


The standard disc labels include the volume label and five types of format labels. 
The volume label includes the address of the volume table of contents which is 
normally the next group of records. The user also has the option of specifying 
additional volume, header, and trailer labels for a disc volume. Format labels 
contain such information as upper and lower limits, identifiers, indicators, lengths, 
counters, addresses, and pointers. The labels are illustrated and described in 

the paragraphs that follow. 


The volume table of contents starts at the beginning of a track if it does not follow 
the volume label group and must terminate at the end of a track. It occupies one extent, 
which is specified when the device is initialized. 


The first record in the volume table of contents is a format 4 label which describes 
the table of contents itself. The second record is a format 5 label, which maintains 
control of the available space in the volume. These two labels are written when the 
volume is initialized and the table of contents is set up. Following the format 4 and 
5 labels are various combinations of format 1, 2, 3, and other format 5 labels. Every 
file and every extent of a file must be accounted for by these labels. 


Refer to UNIVAC 9400 System Supervisor Programmer Reference, UP-7689 (cutrent 
version) for a complete listing of the standard equate labels (STDEQU’s) which 
appear in the following tabulations. 


Disc Volume Labels 


Any disc volume may have one or more volume labels. A four-byte key precedes 
each volume label and is the same as the first four bytes of the volume label itself. 
These first four bytes in the volume label contain the identifier VOLn, where n is 
a number from 1 through 8. The VOL1 label is the standard volume label in the 
system. Others, if present, are user volume labels. The volume labels for discs are 
used in much the same way as tape volume labels (see 2.2.1). The formats of the 
disc volume labels are shown in Figures 2—10 and 2-11. 
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*No STDEQU label applicable. 





DL$VL 
DL$VL1 


* 


DL$VSN 


DL$VSB 


DL$VTC 
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0 1 2 f 
aes 
Rev ee a 
4 VOLUME SERIAL NUMBER 
. 
SECUR 
12 
ig VOLUME TABLE OF CONTENTS ADDRESS 
20 
24 
40 OWNER NAME AND 
at ADDRESS CODE 
48 
52 
RESERVED 
76 
Figure 2~10. Disc Volume 1 Label Format 
Field Code 
Key The key contains VOL1. iene 
Bytes 0—2 EBCDIC Label Identifier — Contains VOL, 
Byte 3 EBCDIC Label Number — Always 1, for initial volume 
label. 
Bytes 4-9 EBCDIC Volume Serial Number — A unique code assigned 
to a disc pack when it enters the system. The 
same code should appear visually on the disc 
pack for operator identification. 
Byte 10 Binary Volume Security — 
0 = No further identification is required for 
each file on the volume. 
1 = Further identification is required. 
Bytes 11-20 Discontinuous Volume Table of Contents Address — This 
Binary field is used on disc volumes to point to the 
format 4 label which starts the table of contents 
of that volume. In bytes 11 through 15, 
the address is of the form cchhr (where 
cc is the cylinder number, hh is the 
head number, and r is the record number). 
Bytes 16 through 20 are 0. 
So 
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STDEQU Label Field Code 

a * Bytes 21—40 Reserved. 

® DLSONR Bytes 41-50 Optional Owner Name and Address Code — A user 
supplied, installation identifier. 

a * Bytes 51-79 Reserved. 


*No STDEQU label applicable. 


LABEL IDENTIFIER 





USER SUPPLIED 


76 


Figure 2-11. Disc User Volume Label Format 
Field Code 

mw Key The key contains VOLn, where n may be 2 
through 8. 

m Bytes 0-2 EBCDIC Label Identifier — Contains VOL to indicate 
a volume label. 

m Byte 3 EBCDIC Label Number — 2 through 8, indicating the 
position of the volume label within the group. 

a Bytes 4—79 User supplied. 


2.3.2. Disc Format 1 Labels 


A format 1 label exists for each file in a volume. It is equivalent to the HDR1 label 
on tape and includes similar fields. As many as three extencs of the file may be 
described in the format 1 label. The format 1 label contains a pointer which, if used, 
indicates the address of either a format 2 or a format 3 label. The schematic form 

of the label is shown in Figure 2—12. A description of the fields within the label 
follows the figure. 
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0 | a 
FILENAME 


(KEY FIELD = 44 BYTES) 


VOLUME 
SEQUENCE # 





RESERVED 


RESERVED 





RESERVED 





FILE TYPE 





RESERVED OPTION CODES RESERVED 








RESERVED RESERVED RESERVED 
RESERVED | RESERVED RESERVED 
RESERVED 











LAST RECORD POINTER 
EXTENT TYPE EXTENT i 
SPARE INDICATOR SEQUENCE # LOWER LIMIT 
LOWER LIMIT UPPER LIMIT 


UPPER LIMIT 


SECOND EXTENT (10 BYTES) 


THIRD EXTENT (10 BYTES) 





POINTER 





Figure 2-12. Disc Format 1 Label 





STDEQU Label Field Code 

a * Key EBCDIC File Identifier — Each file must have 
a unique 1- to 44-byte name in this key 
field. A search of the Volume Table of 
Contents is made on this name. 

a DL$ID1 Byte 0 EBCDIC Format Identifier — Always 1, for format 
1 label. 

# DLS$FS1 Bytes 1-6 EBCDIC File Serial Number — Identifies the volume 


on which the file starts, is a six-digit 
alphanumeric number, and is the same as 

the volume serial number of the volume 

on which the file starts. NY 
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STDEQU label 


Field Code 





m DL$VS1 Bytes 7-8 Binary 

a DL$CD1 Bytes 9-11 Discontinuous 
Binary 

mw DL$ED1 Bytes 12-14 Discontin- 
uous Binary 

a DL$XCl Byte 15 Binary 

mw DL$LDI Byte 16 Binary 

a * Byte 17 

a * Bytes 18-30 EBCDIC 

a* Bytes 31-37 

a DL$FT1 Bytes 38-39 Hexadecimal 

a DL$RFIL Byte 40 Binary 
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Volume Sequence Number — Indicates the 
number of this volume relative to the first 
volume in the file. 


Creation Date — Format is ydd (year-day-day) 


where y is 0 to 99, and dd is 1 to 366. or 


Expiration Date ~ The date when the file 
may be deleted. Format is the same as 
the creation date. 


Extent Count — Specifies the number of 
extents currently constituting the file, or 
portions of it, on this volume. 


Reserved for Directory Block — Used only 
in partitioned files. Indicates the number 
of bytes used in the last directory block. 

Partitioned files are not processed by the 
Data Management System. 


Spare. 
Reserved for Programming System Identifier 


— May consist of any combination of digits 
(0—9), characters (A—Z), and blanks. 


Reserved. 

File Type — 

Hexadecimal 

Code _ Meaning 

4000 Sequential 

2000 Direct Access 
8000 Indexed Sequential 
0200 Partitioned 

0000 Undefined 


Reserved for Record Format — 


Bit Content Meaning 


0,1 01 Variable-length records 
10 Fixed-length records 
11 Undefined format 
2 0 No track overflow 
1 Uses track overflow 
3 0 Unblocked records 
1 Blocked records 
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STDEQU label Field Code 
mw DLS$RFI Byte 40 Binary Reserved for Record Format — (cont.) 
Bit Content Meaning 
4 0 No truncated records 
1 Truncated records in file 
5,6 01 Control character ASCII 
code 
10 Control character machine 
code 
11 Control character undefined 
7 0 Records have no keys 
1 Records have keys 
= DL$OCI1 Byte 41 Binary Option Codes — 
Bit Content Meaning 
0 1 File was created using 
write validity check 
1 1 Allocation by cylinder 
2 1 New file 
3-7 Unused 
ae DL$BLI Bytes 42-43 Binary Reserved for Block Length — Size of 
fixed-length blocks or maximum size of 
variable-length blocks. 
a DL$RLI1 Bytes 44-45 Binary Reserved for Record Length — Size of 
fixed-length records or maximum size 
of variable-length records. 
ae DL$KY1 Byte 46 Binary Reserved for Key Length. 
ma DL$KLI Bytes 47—48 Binary Reserved for Key Location — High order 
position of key field within each data 
record. 
a DL$DS1 Byte 49 Binary Reserved for Data Set Indicators — 
Bit Meaning (when bit = 1) 
0 The last volume of this file 
1 File is not relocatable 
2 Block length is a multiple of 
eight bytes 
3 File is security protected — 
password is necessary 
4 File may not be read 
5 File may not be read by more 
- than one program 
6 File may not be written into 
7 File may not be written into 


by more than one program 
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STDEQU label 


mw DL$SAl1 


a DL$LRI 


g * 


a DL$XT1 


mw DL$XS1 


a DL$XLl 


a DL$XU1 


ge * 


a DL$CP1 


Field 


Bytes 50—53 


Bytes 54-58 


Bytes 59-60 


Byte 61 


Byte 62 


Bytes 63-66 


Bytes 67—70 


Bytes 71-80 


Bytes 81-90 


Bytes 91~95 





Code 





Binary 


Discontin- 
uous Binary 


Hexadecimal 


Binary 
Discontin- 
uous Binary 


Discontin- 
uous Binary 


Discontin- 
uous Binary 


*No STDEQU label applicable. 
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Reserved for Secondary Allocation — 
The amount of storage to be requested 
at the end of an extent. 


Last Record Pointer — Indicates the 
address of the last record written in 

a sequential or partitioned file. The 
format is ttrll, where tt is the relative 
track number, r is the record number, 
and 1] is the number of bytes remaining 
on the track. These bytes are generated 
for an output volume by the FEOV macro 
instruction and are used to control the 
last record location on input. 


Spare. 


Extent Type Indicator — 


Hexadecimal 
Code Meaning 


00 No valid extent described 
01 Prime data area 


02 Overflow area for indexed 
sequential file 


04 High level index area of 
indexed sequential file 


40 User label track area 


8n Reserved for shared cylinder 
indicator, where n = 1, 2, or 4 


Extent Sequence Number — Relative number 
of extent in multiple extent volume. 


Lower Limit — The address specifying the 
start of the extent, in the form cchh. << 


Upper Limit — The address specifying the 
end of the extent, in the form cchh. <— 


Second Extent — Same format as described 
for bytes 61 through 70. 


Third Extent — Same format as second 
extent. 


Continuation Pointer — The address of a 
continuation label, either a format 2 label for 
indexed sequential files or format 3 for extra 
extent descriptors. The address is in the 
form cchhr. Binary 0 if label does not exist. —— 
exist. 
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2.3.3. Disc Format 2 Labels 










































SS 
Format 2 labels are used only with indexed sequential files. For a particular file, 
this label appears in the VTOC of the first (or only) volume containing the file, 
and is addressed by the continuation pointer (bytes 92 through 95) of the format 1 
label for the file. The schematic form of the label is shown in Figure 2—13. A 
description of the fields within the label follows the figure. 
KEY 0 
44 # Mi 1ST PD 
TRACKS RCD IN CYLS 
48 LAST PD TRACK IN CYLINDERS 
52 HIGH HIGH HIGH 
INDEX R PD R OFLR 
56 RESERVED Coane 
60 NON-FIRST OVERFLOW REFERENCE COUNT 
64 | RESIDENT Cl STORAGE REQMT | #CI TRACKS |PD RCD COUNT 
68 PRIME DATA RECORD COUNT STATUS INDC 
if CYLINDER INDEX STARTING ADDRESS 
76 4 
80 MASTER STARTING ADDRESS 
84 
88 (SEE DESCRIPTION) 
92 
PRIME DATA RECORD ADDRESS 
96 
100 TRACK INDEX ENTRY ADDRESS 
104 
108 CYLINDER INDEX ENTRY ADDRESS 
112 MASTER INDEX ENTRY ADDRESS 
116 INDEPENDENT OVERFLOW 
RECORD ADDRESS 
120 
124 RESERVED # REMAINING INDEP OFL TRKS 
FULL CYLINDER 
128 OVERFLOW RECORD COUNT OVERFLOW COUNT 
132 
RESERVED 
136 





: Figure 2-13. Disc Format 2 Label (Indexed Sequential Files) 
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STDEQU Label Field Code 
alt = DL$ID2 Key Key ID — Always X‘02’ — remaining 43 
bytes are reserved. 
a DL$FI2 Byte 44 EBCDIC Format Identifier — Always 2, for format 
2 label. 
ge DL$IL2 Byte 45 Binary Number of Higher Level Indexes — Equals 2 
if both master and cylinder indexes are 
present; equals 1 if cylinder index only. 
a DL$iL2 Byte 46 Binary Number of Master Index Tracks. 
m DL$RC2 Bytes 47-49 Discontinuous First Prime Data Record in Cylinders — 
Binary Value of hhr for first data record in each <~_ 
prime data cylinder. 
a DL$LC2 Bytes 50—51 Discontinuous Last Prime Data Track in Cylinders — 
Binary Value of hh for last prime data track in gam 
each prime data cylinder. 
w DL$TO2 Byte 52 Binary Number of Tracks for Cylinder Overflow. 
a DL$HH2 Byte 53 Binary High Index Record — Value of r for last — 
possible record on nonshared index tracks. 
arn a DL$HP2 Byte 54 Binary High Prime Data Record — Value of r ~~ 
for last possible record on nonshared prime 
data tracks. 
m DL$HO2 Byte 55 Binary High Overflow Record — Value of r for last ~ 
possible record on overflow tracks. 
a DL$LR2 Byte 56 Binary High Shared Prime Data Record — Valuer <~_ 
for last possible record on shared prime 
data tracks. 
at Bytes 57-58 Reserved. 
a DL$TD2 Bytes 59-60 Binary Number of Records Tagged for Deletion — 
Number of records in the file tagged for 
deletion by user. Corresponds to fifenameT; 
refer to Table 4—7. 
wp DLS$NF2 Bytes 61-63 Binary Nonfirst Overflow Reference Count — Number 
of times in random retrieval reference was 
made to an overflow record not the first in 
its chain. Corresponds to filenameR; refer 
to Table 4-7. 
a DL$HB2 Bytes 64~65 Binary Resident Cylinder Index Storage Requirement 


— Number of bytes required to hold entire 
cylinder index in main storage. Corresponds 
to filenameS. (Refer to INDAREA keyword 
for DTFIS, and to Table 4-7.) 


UP-7629 


UNIVAC 9400 





Rev. 2 DATA MANAGEMENT SYSTEM 


STDEQU Label 


se DL$HT2 
a DL$PR2 
= DL$SI2 
{ = DL$CI2 
t = DL$LM2 
—> 
ws DL$HM2 
a DL$LP2 
—> 
= DL$LT2 
= 


—_> a DL$LE2 


Field Code 
Byte 66 Binary 


Bytes 67-70 Binary 


Byte 71 Binary 


Bytes 72—78 Discontinuous 
Binary 


Bytes 79-85 Discontinuous 
Binary 


Bytes 86-92 Discontinuous 


Binary 
Bytes 93-— Discontinuous 
100 Binary 
Bytes 101— Discontinuous 
105 Binary 


Bytes 106— Discontinuous 
110 Binary 
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Number of Cylinder Index Tracks. ~ 


Prime Data Record Count — Total number 
of logical records in prime data areas of 
the file. Corresponds to filename P; refer 
to Table 4-7. 


Status Indicators 
Bit Meaning 


0 Last prime data block written is 
full, 


1 Last prime data track written is 
full. 


2 Last prime data cylinder written 
is full. 


3 Last cylinder-index track written 
is full, 


4-6 Reserved. 


7 First record indicator. 


Cylinder Index Starting Address — Value of ale 
mbbcchh, where m is the volume number, bb 

is two bytes of zeroes, cc is the cylinder 

number, and hh is the head number. 


Master Index Starting Address — Value of 
mbbechh. 


Identical with preceding field (bytes 79~—85); 
maintained for compatibility. 


Prime Data Record Address — Value of 
mbbcchhr, which is the disc address to 
which the last prime data record (r) was 
written, or following which the next prime 
data record will be written. 


Track Index Entry Address — Value of 
cchhr, which is the disc address to 
which the last track index entry was 
written, or following which the next 
track index entry will be written. 


Cylinder Index Entry Address — Value 
of cchhr, which is the disc address to 
which the last cylinder index entry was 
written, or following which the next 
cylinder index entry will be written. 
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STDEQU label 


a DL$MI2 


a DL$LI2 


a DL$BR2 


a DL$IO2 


w DL$OR2 


a DL$CO2 


mw DL$CP2 


Field 


Bytes 111- 
115 


Bytes 116— 
123 


Bytes 124- 
125 


Bytes 126— 
127 


Bytes 128~ 
129 


Bytes 130— 
131 


Bytes 132-— 
134 


Bytes 135- 
139 





Code 


Discontinuous 
Binary 


Discontinuous 
Binary 


Binary 


Binary 


Binary 


Binary 


Discontinuous 
Binary 


*No STDEQU label applicable. 
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Master Index Entry Address — Value of 

cchhr, which is the disc address to —_ 
which last master index entry was written, 

or following which the next master index 

entry will be written. 


Independent Overflow Record Address — 
Value of mbbcchhr, which is the disc —— 
address to which last record in the indepen- 
dent overflow area was written, or following 
which the next record will be written. 


Reserved for the number of bytes remaining 
on overflow tracks. 


Remaining Independent Overflow Tracks — 

Number of tracks in the independent overflow 
area which can still receive overflow records. 
Corresponds to filenamel; refer to Table 4—7. 


Overflow Record Count — Total number of 
logical records in overflow areas of the file. 
Corresponds to filenameO; refer to Table 
4-7. 


Full Cylinder Overflow Count — Total number 
of prime data cylinders containing full cylinder 
overflow areas. Corresponds to filenameA; 
refer to Table 4-7. 


Reserved. 


Reserved for the pointer to a format 3 
label. Binary 0 if label does not exist. 
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2.3.4. Disc Format 3 Labels Set 


A format 3 label is used when there are more than three extents in a file. Each 
format 3 label can describe up to 13 additional extents of a file. The last field of 
the label is a pointer which, if used, indicates the address of the next format 3 
label. However, since a limit of 16 extents per volume are supported by the UNIVAC 

—p OS/4 Data Management System, this field is always 0. The schematic form of the 
format 3 label is shown in Figure 2—14. A description of the fields within the label 
follows the figure. 


0 1 2 3 
KEY IDENTIFICATION 
EXTENT TYPE EXTENT 
INDICATOR SEQUENCE # LOWER LIMIT 


LOWER LIMIT UPPER LiMIT 





EXTENT 4 
{ 
f 
1 


UPPER LIMIT 


KEY 
FIELD 





44 
48 


128 ; 


Figure 2-14. Disc Format 3 Label 
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STDEQU Label 


a DL$ID3 


gw DL$XT3 


gm DL$SN3 


a DL$XL3 


a DL$XU3 


ag * 


a DL$FI3 


mw DL$XS3 
a DL$CP3 


*No STDEQU label applicable. 


Field 
Bytes 0-3 


Byte 4 


Byte 5 


Bytes 6-9 


Bytes 10-13 


Bytes 14—23 


Bytes 24-43 
Byte 44 


Bytes 45—134 
Bytes 135-139 


Code 


Binary 


Discontinuous 
Binary 


Discontinuous 
Binary 


EBCDIC 


Discontinuous 
Binary 
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Key Identification — Each byte contains 0346. 
Extent Type Indicator — 
Hexadecimal 
Code Meaning 
00 No valid extent described 
01 Prime data area 
Extent Sequence Number — relative number 
of extent in this volume of the file. 
Lower Limit — Starting track address of the 
extent, in the form cchh. —< 
Upper Limit — Terminating track address of 
the extent, in the form cchh. << 
Extent 5 — Same format as described for 
bytes 4 through 13 for this extent. 
Extents 6 and 7. 
Format Identifier — Always 3, for format 3 
label. 
Extents 8 through 16. 
Pointer — Address of next format 3 label, in 
the form cchhr. Binary 0 if no further label, —~—t— 
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2.3.5. Disc Format 4 Labels 


The format 4 label describes the volume table of contents itself and is the first 
record in the table of contents. An indicator in the format 4 label states whether a 
format 5 label contains valid information. The schematic form of the format 4 label 
is shown in Figure 2-15. A description of the fields within the table follows the 
figure, 


0 1 2 3 
ee ae 


KEY FIELD 


FORMAT ID LAST ACTIVE FORMAT 1 
AVAILABLE FILE LABEL RECORDS 


HIGHEST ALTERNATE TRACK 


# OF ALTERNATE TRACKS RESERVED | “ever 


RECORD OVERHEAD 





RESERVED 
60 
72 

RESERVED 
92 


Figure 2~15, Disc Format 4 Label 
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STDEQU Label 


a * 
a DL$ID4 
a DL$LF4 


w DLSAF4 


a DL$HA4 


a DL$AT4 
DL$VI4 


m DL$XC4 


go * 


od mw DL$DS4 


gs DL$TL4 


w DL$RO4 


a DL$FG4 


a DL$TO4 


a DL$LT4 
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Field 
Key 
Byte 0 


Bytes 1—5 


Bytes 6-7 


Bytes 8-11 


Bytes 12-—13 


Byte 14 


Byte 15 


Bytes 16—17 


Bytes 18-21 


Bytes 22—23 


Bytes 24—26 


Byte 27 


Bytes 28—29 


Byte 30 


Code 


Binary 
EBCDIC 


Discontinuous 
Binary 
Binary 


Discontinuous 
Binary 


Binary 


Binary 
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Key Field — Each byte of this field contains 041 ¢. 
Format ID — Always 4 for format 4 label. 


Last Active Format 1 — The address, in the 
form cchhr, used for a search on filename. 


Available File Label Records — Number of 
unused records in the volume table of contents. 


Highest Alternate Track — Address, in the 
form cchh, of alternate tracks set aside in 
case of bad tracks. 


Number of Alternate Tracks. 
Reserved for VTOC Indicators — 


Bit Contents Meaning 


0 1 A format 5 label, if present, 


contains invalid information 


1-7 0 Unused 


Number of Extents — Contains 0146 to indicate 
the one extent in the volume table of contents. 


Reserved - 


Device Size — Indicates the number of cylinders 
and the number of heads per cylinder on the 
device, in the form cchh. 


Track Length — Number of available bytes on 
a track exclusive of home address and Record 0. 


Record Overhead — ILK describes overhead 
bytes on track, where I is for keyed record 
which is not the last on track, L is for keyed 
record which is the last on track, and K is a 
decrement applied to records which have no key. 


Flag — 

Bit Meaning * 

0-5 Reserved 

6,7 Device-dependent character- 
istics 


Tolerance — A device-dependent factor which 
is used to calculate effective record lengths 
for that device. 


Labels per Track — A device-dependent factor 
specifying the number of 140-byte labels 
possible in a volume table of contents track. 
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a DL$BT4 Byte 31 Blocks per Track — A device-dependent factor 
specifying the number of directory blocks of a 
partitioned file which can be written on a track. 


a * Bytes 32-60 Reserved. : 


mu DL$VX4_ Bytes 61—70 VTOC Extent — Describes the extent occupied 
by the VTOC itself. The format of this field is 
identical to the fields describing the extent in 
the format 1 and 3 labels. 


Bytes 71-95 Reserved. 


*No STDEQU label applicable. 


2.3.6. Disc Format 5 Labels 


The format 5 label is the second record in the volume table of contents and is used 
to maintain control of the available extents in the volume at any time. If several 
format 5 labels are valid, they are linked to each other. The schematic form of the 
format 5 label is shown in Figure 2-16. A description of the fields within the table 
follows the figure. 


0 1 2 3 





0 KEY IDENTIFICATION 


4 | RELATIVE TRACK ADDRESS | # OF CYLINDERS IN EXTENT 
#0 
as abe Coes AVAILABLE EXTENT 


16 AVAILABLE EXTENT 


AVAILABLE EXTENTS 


FORMAT ID 


AVAILABLE EXTENTS 





Figure 2-16. Disc Format 5 Label 
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— STDEQU 
Label Field Code 
a DL$IDS- Bytes 0-3 
a DL$XTS Bytes 4—5 Discontinuous 
Binary 
a DL$XC5 Bytes 6-7 Binary 
me DL$XE5 Byte 8 Binary 
a* Bytes 9—13 
a * Bytes 14~—43 
a DLS$FIS5 Byte 44 EBCDIC 
= DL$XS5_ Bytes 45-134 
ae DL$CP5 Bytes 135-139 Discontinuous 
Binary 
. *No STDEQU label applicable 
ee? 
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Key Identification — Each byte of this field 
contains 054¢- 


Relative Track Address — Start of extent. 


Number of Cylinders in Extent. 


Number of tracks in extent in addition to the 
cylinders. 


Available Extent — Describes another extent 
in fields with the same format as bytes 4 through 
8 above. 


Six more available extents. 
Format ID — Always 5, for format 5 label. 
Eighteen more available extents. 


Pointer — Indicates the address of another 
format 5 label, in the form cchhr. Binary 0 <— 
if no further label. 


Each volume of a file may have up to eight user header and eight user trailer labels. 
A four-byte key precedes each label. For header labels it contains UHL1 through 
UHL8; for trailer labels it contains UTLO through UTL7. A schematic form of the 


label is shown in Figure 2-17. 


LABEL IDENTIFIER 





n 





LABEL NUMBER 


USER SUPPLIED 


76 


Figure 2-17. Disc User Header/Trailer Label 
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m Key 


mg Bytes 0-2 


mw Byte 3 


m Bytes 4-79 
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The key contains UHLn for header labels or 
UTLn for trailer labels. The range of values 
for n may be 1 through 8 for header labels 
and 0 through 7 for trailer labels. 


Label Identifier — For disc header labels these 
bytes contain UHL; for trailer labels, UTL. 


Label Number — The number of a user disc 
header or trailer label ranges from 1 to 8. 


User supplied. 


Track Organization for User Header/Trailer Labels 


Standard user labels may be processed by both the sequential and direct access 
methods. The sequential access method processes both header and trailer labels; 
the direct access method processes header labels only. 


The user labels must be in the first track of the first extent for each volume of the 
file. There may be a maximum of eight header labels and eight trailer labels for each 


volume of a file. 


The labels are each 80 bytes long and the four bytes preceding the label contain a 
key. For header labels, the key is UHL1...UHL8. The key for trailer labels is 


UTLO...UTL7. 


A diagram of the relational position of the header and trailer labels on a track for a 
file accessed by the sequential access method and a file accessed by the 

direct access method is shown in Figures 2-18 and 2-19. An explanation 

of the user labels follows each figure. 


R1 





HEADER LABELS 





R(n+2+m+1) 


TRAILER LABELS 


Figure 2—18. Sequential Access Method Track User Label Format 


The range of values for n is 1 through 8 and for m is 0 through 7. An explanation of 


the content of each record follows. 
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RO 


Rl 


R(n) 
R(n+1) 


R(n+2+m) 


R(n+2+m+1) 


2 31 


Record 0 has no key. Both the length of the data and the contents 
are standard. 


The key is UHL1. 
The length of the label is 80 bytes. The first four bytes of the 
label are UHL1; the remaining 76 bytes are user supplied. 


The key is UHL(n). 
The length of the label is 80 bytes. The first four bytes of the 
label are UHL(n); the remaining 76 bytes are user supplied. 


The key is UHL(n+1). 
The length of the label is 0. This is a file mark recognized by 
logical IOCS. 


The key is UTL(m), 
The length of the label is 80 bytes. The first four bytes of the 
label are UTL(m+1); the remaining 76 bytes are user supplied. 


The key is UTL(m+1). 
The length of the label is 0. This is a file mark recognized by 
logical IOCS. 





Rl 





oT 











R(n+2) 


HEADER LABELS TRAILER 
LABEL 





Figure 2-19. Direct Access Method Track User Label Format 


The range of values for n is 1 through 8. An explanation of the content of the records 
follows. 


RO 


R1 


R(n) 


R(n+1) 


R(n+2) 


Record 0 has no key. Both the length of the data and the contents 
are Standard. 


The key is UHL1. The length of the label is 80 bytes. Fhe first 
four bytes of the label are UHL1; the remaining 76 bytes are 
user specified. 


The key is UHL(n). The length of the label is 80 bytes. The first 
four bytes of the label are UHL(n); the remaining 76 bytes are 
user specified. 


The key is UHL(n+1). The length of the label is 0. This is a 
file mark recognized by logical IOCS. 


The key is UTLO. The length of the label is 0. This is a file 
mark recognized by logical IOCS. 
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2.3.9. Record Types 


There are two main record types on direct access storage devices: with a key 
field or without a key field. These are illustrated in Figure 2—20. 





Count 


K Data 
(8 bytes) - 


Count Data 


(8 bytes) 


Figure 2~20. Disc Record Types 


The count field is required by the hardware and is illustrated in detail in Figure 
2-21. This field is used to describe the physical location of the record and the 
length of the key and data fields. The size of the count field is always 11 bytes, 
although only 8 bytes are transmitted into and out of the processor. The remaining 3 
bytes are generated by the control unit and are not available to the user. Allowance 
must be made for the count field (8 bytes) when specifying the size of output areas 
as described in later sections. 


The key field is optional and is used only when the data is located by means of a 
search on a key. The key field can vary in size from 3 to 255 bytes. However, 
within one file, all keys must be the same length. 


The data field may be any length up to a maximum of 3625 bytes for the UNIVAC 
8411 Disc Subsystem or 7294 bytes for the UNIVAC 8414 Disc Subsystem, and 
the UNIVAC 8424 Disc Subsystem. 


Cylinder 


® 
2 
> 
a 
cr) 
= 
w 


Key Length 


Identifier 





Figure 2~21. Count Area on Disc 
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; m Flag Byte 
ae 
This byte is automatically supplied by the control unit as records are written. 
However, the byte is not available to the user. The significance of the bits in 
the flag byte is as follows: 
Bit Function 
0 0 = Even numbered records 
1 = Odd numbered records 
1 0 = Nonoverflow (normal) records 
1 = All segments, except the last, of overflow records 
2-5 Always 0 
6 0 = Operative track 
1 = Defective track 
7 0 = Primary track 
1 = Alternate track 
mw Identifier 
The identifier is normally the address of the count area itself and is composed 
of the cylinder, head, and record numbers. 
— Cylinder Number 
; These bytes indicate the cylinder number of the track on which the data is 


stored. 


— Head Number 


These bytes indicate the read/write head number of the track on which the 
data is stored. 


— Record Number 


This byte indicates the sequential number of this record on the track. 
A maximum value of 255 is allowed by this eight-bit binary number. 


m Key Length 


This field specifies the number of bytes in the key area of the record. Lengths 
from 3 to 255 bytes are possible, or 0 if no key length specified. 


a Data Length 


This field specifies the number of bytes in the data area of the record. A data 
length of 0 causes one byte of binary 0’s and two check bytes to be written. On 
reading, no data is transferred to the I/O channel and an end-of-file mark is 
indicated. 


m Cyclic Check 


These bytes permit error checking of the information read from the count area, 
but the bytes are not available to the user. 
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2.3.9.1. Sequential Disc Files 


Records may be grouped into blocks when more than one logical record equals a 
physical record.. Records also may be unblocked when only one logical record equals 
a physical record. The format of individual records may be fixed length, variable 
length, or undefined. If the record format is undefined, the records are assumed to 
be unblocked and any deblocking must be supplied by the user. Figures 2—22 and 
2-23 illustrate the formats of fixed-length and variable-length records. Comparisons 
may be made with Sections 2.2.4.1 and 2.2.4.2 which describe tape record formats. 


Fixed-Length, Blocked Records 


Record n+2 


Record n 





Figure 2~22. Disc Fixed-Length Records ~ Sequential Files 


Files with variable-length records may have either blocked or unblocked records. 
The length of the block must be specified and must precede the record(s) in the 
block. The number of bytes in a variable-length record must be specified and must 
precede the data in the record. Figure 2—23 illustrates the format of both blocked 
and unblocked variable-length records. 
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Variable-Length, Unblocked Records 














Variable-Length, Blocked Records 


Record Ny 





$44 * 
el |-~-——_—_——. a ——_> |+-________—__ 2, — 
J]_ $$$» —__ 


LEGEND: 


b — Block length (2 bytes) 

a — Record length (2 bytes) 

X-— Reserved for system use (2 bytes) 
d ~— Data field in the record 

GAP — Disc (hardware) gap 


Figure 2~23. Disc Variable-Length Records — Sequential Files 
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2.4. CARD AND PRINTER CONVENTIONS 


Data Management utilizes certain card and printer conventions established by the 
UNIVAC OS/4 Operating System in processing card files. 


2.4.1. Start-Of-Data ($ Job Control Statement) 


Data Management does not check for a start-of-data card. If the user is filing data 

as a Job Control option, the start-of-data (/$) card must be included in the job stream. 
For consistency the user may choose the /$ card convention as a card file identifi- 
cation. In this case the problem program should include a check for this card. 


2.4.2. End-Of-Data (* Job Control Statement) 


Data Management checks for an end-of-data card when the user is reading EBCDIC 
cards. The format of this card is identical to that required by Job Control. The 
first two columns contain /*. When this configuration is sensed, control is trans- 
ferred to the end-of-file address specified for the file. When an output file is punch- 
ed, the end-of-data card is not punched. 


2.4.3. Printer/Punch — First Character Control 


The user has the option of specifying in the DTF PR or DTFCD macro instruction 

that a control character is to be included in the data records. This character specifies 
line spacing or skipping when the file is printed or stacker selection when the file 

is punched, The character itself is never printed or punched but is a part of the 
record in storage. If the record is sent to a device, such as the disc, that does not 
recognize this control character, the system assumes that the control character is 
data. If the record is sent to a punch ora printer and the user has not specified 

that the record contains a control character, the character is handled as data. I/O 
areas must be large enough to include this character. 


When fixed-length or undefined record formats are used, the control character is the 
first character in the record (see Figure 2—24 and Figure 2—25). It is the first char- 
acter following the record length specification in a variable-length unblocked record 
format (see Figure 2—26). The block size of the output area must include the byte 
for the control character. If variable-length, unblocked records are to be processed, 
the block size must account for the initial eight characters as well as the control 
character (nine bytes total) in the output area. Although these characters do not 
appear in the output, the output area must be large enough to accommodate them. 

It must also be noted that when a control character is specified, every record must 
contain a control character. 

When a PUT macro instruction is executed, the control character (for the character 
required, see the CTLCHR keyword parameter under the appropriate DTF macro 
instruction) in the data record becomes the command code (one byte) of the Channel 
Command Word (CCW). The first character after the control character in the output 
data is the first character printed or punched. 


If the command parameter within a CNTRL macro instructien is to be issued for the 

punch or printer, the CNTRL keyword parameter is specified and CTLCHR must be 

omitted. First character control must not be specified when the read/punch feature 
—_> of the UNIVAC 0604 Card Punch Subsystem is used for combined files. 
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Cc DATA 


—_—_———nnnmemm—=s, Record Length qe mm 


Figure 2—24. Fixed-Length Record Format 


Cc DATA 


eee Record Length eee eee 


Figure 2—25. Undefined Record Format 


+H Block Length | 


——__—— Record Length  _ 








LEGEND: 


b — Block length (two bytes) 

a — Record length (two bytes) 

X — Reserved for system use (two bytes) 
C — Control character (one byte) 


Figure 2—26. Variable-Length, Unblocked Record Format 
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3. SEQUENTIAL FILE 
PROCESSING 


3.1. GENERAL 


All files with records that follow one another in a serial or physicaily adjacent manner 
are processed by a sequential access method. Devices which may have sequential 
files include magnetic tape units, card readers, printers, punches, and direct access 
storage units (discs). Each file for each device must be defined by a declarative macro 
instruction which generates the necessary constants. 


The problem program handles and processes records, blocks, and files by issuing 
imperative macro instructions which are expanded into executable code in-line with the 
user’s instructions. 


This section describes the declarative macro instructions for each device and the 
imperative macro instructions for processing the files. 


3.2. DECLARATIVE MACRO INSTRUCTIONS 


A problem program must include the following declarative macro instructions to define 
the files for any devices which may be accessed in a sequential manner. 


DTFMT — Magnetic Tape 

DTFSD — Direct Access Storage Device 

DTFCD — Card Device 

DTFPR — Printer 

DTFOR — Optical Document Reader ge 
DTFPT — Paper Tape 


The symbolic name for the file has a maximum of seven characters and must begin 
with an alphabetic character. The keyword parameters may appear in any order and 
must be separated by commas. 


3.2.1. Magnetic Tape 


The declarative macro instruction, DT FMT, is required for both input and output 
magnetic tape files. Following is a listing in alphabetic order of the required and 
optional keyword parameters which may appear in the operand of the DTFMT macro 
instruction. 


A description of each keyword parameter follows the listing. A summary of the 
keyword parameter is given in Table 3—1 following the descriptions. 
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LABEL B OPERATION 5 OPERAND 


BKSZ=n 

EOFA=symbol (Input Files Only) 
IOA1l=symbol 

{[BKNO=YES] 

[CKPT=YES] 


RWD 
[cirw- oewe | 


IGNORE 
ERRO=. < SKIP 


filename 


symbol 
[ERROR=symbol] 

STD 

FLBL= pesto} 

NO 
[10A2=symbol] 
[IORG=(r)] 
[LBAD=symbol] 
[OPTION=YES] 
[OPRW=NORWD] 





FIXUNB 
FIXBLK 
RCFM= < VARUNB 
VARBLK 
UNDEF 
n 
RCSZ= (r) 
FORWARD 
READ= pack i 
[TPMK=NO] 
INPUT 
rye. jourrut| 
INOUT 
(VBLD=(r)] 
([WORK=YES} 


NOTE: Assembler rules concerning commas and continuation of parameters in the 
operand field apply when writing this macro instruction; see 1.2. 


@ Block Numbering 


The user may specify whether tape blocks are to be numbered by the VOL statement 
card in the control stream or by the following keyword parameter. 


BKNO=YES 


When this keyword parameter is specified, logical IOCS checks input tapes for 
block numbering or writes binary block numbers on output tapes. Block numbers 
begin with 1 and are incremented sequentially by one. All label, data, and 
checkpoint blocks are numbered. Tape marks are counted but cannot have a 
number as part of the tape mark. 


Block numbers are written as part of the block, and require an additional three 
bytes which are the first three bytes in the block. These additional bytes are 
not reflected in the value of the block size parameter BKSZ, but they must be 
considered when the block size approaches the maximum/minimum hardware 
physical block size. 
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er When this keyword parameter is specified, a four-byte storage area aligned on a 
fullword boundary must immediately precede the area defined by IOA1 (and IOA2, 
if used). The I/O area(s) must also be located on a fullword boundary. The four- 
byte storage area is not included in the definition of IOA1, IOA2, or BKSZ. 


Following is an example of fullword alignment and storage allocation for block 























numbering. 
LABEL 6 OPERATIONS OPERAND 6 
1 10 16 
O44 pt Ft wor a] yal iggingmemmyt] py pai 
Kea’ Ova fy Fowler y buy tle, jbii miayriy, | zle,rio, s, 
Chinen py Pa ZO] par eso] My toa pa 
eb ee os gpl eg oP he Se i ee Po pe pe es pe pl 
Xb .4,', 01! 170) sorie a 2 iif] wise) | pd 
MO binn yg pe dt a 
GSpot ofall eye path eg ag St eg at Ei oie Ah pe Sy 























NOTE: BKSZ = d(nn) of the define storage (DS) 


If IOA2 is specified, the same conventions regarding block numbering are applicable. 


On a forward read with block numbering, logical IOCS reads into IOA1~3 a block 
of length BKSZ +3 and checks the three-byte block number. 


On a backward read with block numbering, logical IOCS reads into IOA1 + (BKSZ—1) 
a block of size BKSZ+4. The three-byte area preceding the actual block is checked 
to ensure a correct block number. The additional (fourth) byte is used to ensure that 
the length of IOA1+3 is large enough to contain the data and block number for check- 
ing without destroying other data. If the block on the tape exceeds the specified 
BKSZ+3, the use of the fourth byte indicates this fact and an error condition is gen- 
erated. On a backward read without block numbering, logical IOCS reads into 

IOA1 + (BKSZ~—1) a block of size BKSZ+1. 


On a write with block numbering, logical IOCS writes from IOA1-—3 a block of length 
BKSZ+3. Logical IOCS inserts the current block number in the least significant 
three bytes of the reserved four-byte field immediately proceding IOA1 before 
writing. 


On a backward read with nonstandard labels and no LBAD routine specified, any 
user labels may cause a BKNO error, if block number checking is desired. 


When writing tape marks, the block number is updated but is not written. When 
treading a tape mark, the block number is updated only, since no checking can be 
performed. 


The block number is never addressed as a data record, nor is it passed as part of 
a user’s label. The block numbering option can be used with 9-track tapes or 
7-track tapes if data conversion and no translation is specified. 
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w Block Size 


This keyword parameter is required for both input and output files. The format is: 
BKSZ=n 


where n (decimal) is the length or size of the block in bytes. For all record formats 
the minimum block size allowed is 18 bytes. For variable-length blocks, n is equal 
to the maximum size for blocks in this file and must include the block and record 
length fields. However, BKSZ must not include the additional block numbering bytes, 
or the extra byte required for a backward read operation; that is, when BKNO=YES 
and READ=BACK are specified. 


The maximum size of a block on magnetic tape is 4095 bytes on the UNISERVO VI-C, 
32,767 bytes on the UNISERVO 12, and 32,767 bytes on the UNISERVO 16. 


All of the minimum and maximum block sizes, however, will be affected whenever 
block numbering (BKNO=YES) and read backward (READ=BACK) processing are 
specified. 


Bypass Checkpoint Dumps 


If an input file has checkpoint blocks interspersed with data, the checkpoint 
records are bypassed if the following keyword parameter is specified: 


CKPT=YES 
Rewind at CLOSE 


A tape may or may not be rewound when a file is closed. If this parameter is 
omitted, the tape is rewound with interlock when a file is closed. 


— CLRW=RWD 


This keyword parameter is used if a tape is to be rewound without interlock 
when a file is closed. 


— CLRW=NORWD 


This keyword parameter is used if a tape is not to be rewound when a file is 
closed. 


End of an Input File 


The address to which control is transferred when the tape mark following an end 
of data is sensed must be supplied by the following keyword parameter: 


EOF A=symbol 


where symbol (label) is the address of the routine which performs end-of-data 
processing. This keyword parameter is required for all input files. 


Unique File Errors 


A unique error for tape is a parity error from which physical IOCS has tried 
unsuccessfully to recover. If a unique error occurs when reading a block of an 
input tape, the user has the following options. He may process the block as if 
no error had occurred, bypass the block, enter a special routine for individually 
processing error blocks or terminate the job. The absence of this parameter 
specification will cause logical IOCS to assume that a job should be terminated 
if a unique error occurs. The other options are specified as follows: 
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— ERRO=IGNORE 


This option permits the images in the I/O area to be available to the user as 
though no error had occurred. 


— ERRO=SKIP 


This option causes the block in error to be bypassed and the next error-free 
block to be accessed. 


— ERRO=symbol 


For this option, symbol (label) is the address of a user routine to process 
unique errors. 


User tape files that specify the ERRO address option should note the following 
when setting up their routine at the ERRO address: 


User must not change the present register save area. 
Register 13 must be maintained after processing. 
Data Management macros on the file should not be issued. 


The ERRO record should be accessed through the address passed in register 1; 
address is start of data block. If PIOCS is used, another save area must be 
supplied. 


R Return to Data Management modules must be by way of address in register 14. 


Data Management assumes the user return is set to skip the error. If he wishes 
to ignore the error and process the block, he must turn off the skip switch in 
the DTF (NI DT$FG2,X‘EF’), and turn on the ignore switch in the DTF (OI 
DT$FG2,X‘20’); see 1.5. 


Returning to the Data Management modules with neither (or both) of the skip 
or ignore switches set takes the user to the ERROR address, if any, or cancels 
his job. 


m Major File Error 


When a fatal hardware or detectable logical error occurs on a file, the user may 
have control transferred to a special error handling routine by specifying the 
following keyword parameter: 


ERROR=symbol 


where symbol (label) is the address of the error handling routine. When logical 
IOCS transfers control to the routine, registers 1 through 12 are restored. If 
control is passed to the ERROR address from a processing macro instruction 
(such as GET or PUT), the address of the instruction following the macro 

call is found in register 14. Register 14 is restored to the value in the register 
preceding the transient call (OPEN, CLOSE, and FEOV). Register 0 contains 
the following information concerning the reasons for the error: 
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— Bytes 0 and 1 reflect the first and second hardware sense bytes if the error 
is a hardware error; otherwise, these bytes contain binary zeros. 


— Byte 2 contains a one-character EBCDIC value indicating in what section of 
processing the error occurred, where 4 = transients and 1 = processing. 


— Byte 3 contains a one-character EBCDIC value indicating the reason for the 
error; refer to Appendix E. 


Transient routines also cause an informational typeout, inserting bytes 2 and 3 
as xx in the standard Data Management message format (DMxx). If this keyword 
parameter is not specified, abort procedures are executed when a major file error 
occurs. 


Further access of the file is not permitted after a major file error has occurred. 


a Tape Labels 


The type of labels on a tape must be specified. They may be standard, nonstandard, 
or undefined. The formats of the keyword parameter for the three types of labels 
are: 


— FLBL=STD 
This is the keyword parameter to use for tapes with standard labels. 


— FLBL=NSTD 


This is the keyword parameter to use for tapes with nonstandard labels. The 
user must provide a routine to create the labels for output files or to check 
the labels on input files. The address of the routine to handle user file labels 
is supplied by the keyword parameter LBAD. If nonstandard labels are present 
on input files but are not to be checked, LBAD is omitted. If the input file 
labels are not checked, a tape mark must precede the data. 


—- FLBL=NO 


This is the keyword parameter to use if the tape is unlabeled. 


mw Input/Output Area 


Each input or output file must have an area reserved for its individual use. The 
area must be defined by the following keyword parameter: 


IOA1l=symbol 


where symbol (label) is the address of the I/O area. For variable-length records 
or blocks, the I/O area for the file includes the bytes of block and record length 
information. For backward or forward processing, if a block numbering option is 
desired (see BKNO=YES or the VOL Job Control statement), four bytes for storing 
the block number must be reserved immediately preceding the labeled I/O area, 

If read backward processing is specified, and no block numbering is desired, one 
byte must be reserved preceding the I/O area for validating block length. Logical 
IOCS handles all modifications necessary to write block numbers for output files 
and to check block numbers on input files. 
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NOTE: If standard labels are specified with user labels present and an LBAD 
routine is also specified, the I/O area must be at least 80 bytes in 
length to accommodate the user label. 


w Secondary Input/Output Area 


A secondary I/O area for standby processing improves efficiency by overlapping 
1/O and record processing time. The format of the keyword parameter for a secondary 
I/O area is: 


IOA2=symbol 


where symbol (label) is the address of the secondary I/O area. It is subject to 
the same requirements as noted in IOAI. 


m Current Record Pointer 


When a general register is used as an index register to reference current data, 
the following keyword parameter should be specified: 


IORG=(r) 


where (r) is the number of the general register (2—12). If a work area is not 
required, this keyword parameter must be specified when there are two I/O 
areas, or records are blocked. When read backward processing is desired and 
a work area is not specified, this parameter is also needed for variable length 
or undefined records. 


For input files, logical IOCS places the address of the next available record in 
the specified register. 


For output files, logical IOCS places the address of the next available I/O output 
area in the specified register. 


@ Special Label Handling 


This keyword parameter supplies the address of a user routine which processes 
user header or trailer labels, either standard labels or nonstandard labels. The 
format is: 


LBADzsymbol 


where symbol (label) is the address of the user routine. When used, the LBAD 
routine may not retain control for more than 500 milliseconds; otherwise a TIME 
LIMIT error will result. 
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— Standard Labels 


The special label handling routine must be capable of processing both header ae 
and trailer labels for files with standard labels. During the processing of the 
OPEN transient routine, the user receives control after the HDR1 header label 
has been checked on an input file or after the HDR1 has been written on an 
output file. For read backward processing, the user receives control after 

the bypassing of the first end-of-reel tape mark. He is then positioned to read 
the user’s trailer labels. In any case, the user cannot access the HDRI1 or 
EOF 1 label. For both input and output files, logical IOCS places the EBCDIC 
character O, denoting OPEN, in the low order byte of register 0 and places 

the address of the I/O area in register 1. The input label pointed to by the 
address in register 1 is available for processing; labels for output files can 
be built in an 1/O area which is pointed to by register 1. The special label 
handling routine must return control to logical IOCS by means of the LBRET 
macro instruction with the proper option specified (see 3.3.7). Logical IOCS 
completes the processing and prepares the file for the first GET or PUT macro 
instruction. 


On input, after an end-of-volume (EOV1) label has been processed, for each 
EOV2-8 or UTL read, logical IOCS places an EBCDIC character V in register 

0, loads register 1 with the I/O address of the label, and transfers control to 
the user’s LBAD routine. All labels are processed or bypassed until a tapemark 
is encountered. At this time logical IOCS executes the end-of-volume procedures 
to close the current volume and open the next. 


On input, after the end-of-file (EOF1) label has been processed, logical IOCS 
transfers control to the user’s end-of-file (EOFA) routine. The user is expected 
to issue a CLOSE macro instruction, following which, if LBAD is specified, 
and for each EOF2-8 or UTL label read, logical IOCS places an EBCDIC 
character F in register 0, loads register 1 with the I/O address of the label, 
and transfers control to the user’s LBAD routine, All labels are processed or 
bypassed until a tapemark is encountered, At this time the resetting of the 
DTF and CLOSE rewind procedures take place. 


eed 


On output, after an end-of-volume (end tape) condition is encountered, the 
end-of-data tapemark and EOV! label are written. Then logical IOCS places 
an EBCDIC character V in register 0, loads register 1 with the designated 
I/O area address in which the label is to be placed, and transfers control to 
the user’s LBAD routine, if specified. All user trailer labels will be written 
until a LBRET 1 macro instruction is issued. At this time two tapemarks are 
written, the tape is rewound with interlock, a volume swap occurs, and the 
next output volume is opened. 


On output, after an end-of-file (CLOSE) condition is encountered, the end-of- 
data tapemark and EOF 1 label are written. Then logical IOCS places an 
EBCDIC character F in register 0, loads register 1 with the designated I/O 
area address in which the label is to be placed, and transfers control to the 
user’s LBAD routine. All user labels will be written until a LBRET 1 macro 
instruction is issued, at which time two tapemarks are written and the CLOSE 
rewind options take place. . 
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For read backward processing, end of volume and end of file are synonymous. 
This condition is assumed when logical IOCS senses the tapemark between 

the data blocks and the header labels. Logical IOCS loads the EBCDIC charac- 
ter F into register 0, places the address of the I/O area in register 1, and 
transfers control to the user’s LBAD routine, if specified. Once any UHL’s 

or HDR2-8 labels are processed, all further labels are bypassed until either 

a tapemark or load point is encountered. Logical IOCS then transfers control 

to the user’s end-of-file routine (EOFA) in which the user issues a CLOSE 
macro instruction for the file. 


— Nonstandard Labels 


The user must process all labels by a special label handling routine when files 
have nonstandard labels. 


On input, when such a tape file is concerned, logical IOCS executes the user’s 
rewind option (OPRW) places an EBCDIC character O in register 0, and transe 
fers control to the special label handling routine. If LBAD is not specified for 
the input file, logical IOCS positions the tape to the first record following the 
tape mark. If the tape mark is not present, logical IOCS cannot distinguish 
between labels and data. Therefore either LBAD must be specified or a tape 
mark must precede the data. When the special label handling routine finishes 
processing labels, it returns control to logical IOCS by means of the LBRET 
macro instruction. 


Before control is transferred to the special label handling routine when logical 
IOCS senses the tape mark at the end of the data, an EBCDIC character E is 

ee’ placed in register 0, while the address of the I/O area containing the label is 
placed in register 1. After processing label(s), the routine returns control to 
logical IOCS by means of the LBRET macro instruction with the EBCDIC 
characters either EF or EV right justified in register 0. 


When the EF characters are stored (or LBAD is not specified), logical IOCS 
branches to the user’s end-of-file address as specified in the EOFA keyword 
parameter. When the EV characters are stored, logical IOCS executes the 
end-of-volume procedures to close the current volume and opens the next. 


For read backward processing, logical IOCS assumes the tape is positioned 
properly for OPEN, and bypasses the tape mark, and then reads the last user 
trailer label. Control is then transferred to the user’s LBAD routine, if specified, 
with register 0 containing the EBCDIC character O and register 1 containing the 
address of the label area. Once any user trailer labels are processed, the tape 

is positioned beyond the tape mark which follows the data, For each user 

trailer label processed by the user’s LBAD routine, the user must return to 
logical IOCS by way of the LBRET macro instruction. 


When the tape mark preceding the data is encountered, logical IOCS places an 
EBCDIC character E in register 0, places the address of the label area in 
register 1, and transfers control to the user’s LBAD routine, if specified. For 
each user header label processed by the user’s LBAD routine, the user must 
return to logical IOCS by means of the LBRET macro instruction (see 3.3.7), 
with register 0 containing the EBCDIC characters EF, right justified. 
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This cycle continues until all labels are either processed or bypassed and 
either a tape mark or load point is encountered. Control is then transferred to 
the user’s end-of-file routine (EOFA) in which the user should issue a CLOSE 
macro instruction for the file. 


On output, logical IOCS enables the user to write the header (or trailer) labels 
by loading register 0 with an EBCDIC O (or V or F), loading register 1 with the 
address of the I/O area in which the label is to be placed, and then transferring 
control to the user’s LBAD routine. For each label to be written, the user must 
return by way of a LBRET 2 macro instruction, with register 0 containing the 
length of the label. 


Refer to Appendix A.1 for descriptions of tape label processing in the Job 
Control/Logical IOCS interface. 


w Optional Input File 
The keyword parameter to allow the user to specify an optional input file follows: 


OPTION=YES 


When this keyword parameter is specified and the file has not been allocated to 
a device by Job Control, the OPEN transient routine ensures that logical IOCS 
will transfer control to the address of the user’s end-of-file routine (EOFA) 
following the execution of the first GET macro instruction. This procedure 
maintains continuity in the user’s program. The user is required to CLOSE the 
optional file. 


When this keyword parameter is not specified and the file has not been allocated 
by Job Control, it is impossible to obtain records from the file, if one exists. 
Logical IOCS transfers control to the address of the user’s error routine (ERROR). 
If a user error routine is not supplied, the job step is aborted. 


m Rewind at OPEN 


If the reels of a file are not to be rewound before labels are checked during the 
processing of the OPEN macro instruction, the following keyword parameter 
should be specified. 


OPRW=NORWD 


Otherwise reels are rewound at OPEN time. When read backward processing is 
specified, NORWD is assumed. 
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@ Record Format 


The record format of a file is specified by a keyword parameter. There are five 
options to indicate whether the records are fixed length, variable length, blocked, 
unblocked, or undefined. The options are coded as follows: 


— RCFM=FIXUNB Fixed-length, unblocked 

— RCFM=FIXBLK Fixed-length, blocked 

— RCFM=VARUNB Variable-length, unblocked 
— RCFM=VARBLK Variable-length, blocked 
— RCFM=UNDEF Undefined 


Logical IOCS assumes a fixed-length, unblocked record format when this keyword 
parameter is not specified. 


Record Size 


The number of bytes in a record is made available to logical IOCS by this keyword 
parameter. Logical IOCS assumes that the record size is equal to the block size 
for fixed-length, unblocked records and that the size of the record is available 

in the first two bytes of each variable-length record. 


— RCSZ=n 


This form of the keyword parameter should be used for fixed-length, blocked 
records, where n is the number of bytes in the record. 


~ RCSZ=(r) 


This form of the keyword parameter is required for output files with an undefin- 
ed record format. The general register (2~12) specified by (r) contains the 
block length. The keyword parameter may also be used for input files with an 
undefined record format. Logical IOCS places the block length into the general 
register specified by (r). 


@ Input File Direction 


Logical IOCS assumes that input files are to be read in a forward direction. 
Input files may also be read in a backward direction. 


— READ=FORWARD 


This form of the keyword parameter is specified, if an input file is to be read 
forward. 


— READ=BACK 


This form of the keyword parameter is required, if an input file is to be read 
backwards. A byte must then be allocated before each I/O area, as described 

in the block numbering section. Also, the user is limited to handling one volume 
only during backward processing. 
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@ Tape Mark Following Header Labels 


For output files with nonstandard labels or no labels, a tape mark usually 
separates the labels and the data. If, however, the user wants to eliminate 
the use of the tape mark, the following keyword parameter should be specified: 
TPMK=NO 
It is the responsibility of the user to be able to differentiate between header 
labels and data. 
a Type of File 
The type of file is specified by this parameter. 
— TYPE=INPUT 
This keyword parameter specifies an input file (one that is to be read). This 
option is assumed if the parameter is not specified. 
-— TYPE=OUTPUT 
This keyword parameter specifies an output file (one that is to be written). 
- TYPE = INOUT 
This keyword parameter specifies a file which can be used either as an output 
or input file. 
It is assumed the user wants the file to be an output type first, and the DTF is ee 


set up accordingly. After the use of the file as an output type, the user can 
change to an input file by resetting the DTF File Type indicator (bit 7 of 
1 DC$FG1) before re-opening the file. 


DTFD with MT=YES must be included in the program (1.5.1). 
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If the user wants the option of READ = FORWARD or BACK when a combined 
file is selected, the READ = BACK parameter must be selected. When this 
parameter has been selected in a combined file environment, it is assumed 

that the first time the file is opened as an input type, the user will want the 

file read in a backward direction. After the use of the input file in a backward 
direction, the user can change to an input file in a forward direction by resetting 
the DTF Input File Direction indicator (bit 3 of DC$FG2) before re-opening the 


file. | 


DTFD with MT=YES must be included in the program (1.5.1). 
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m Variable-Length Record Residual Space 4 


For output files with variable-length blocked records to be processed in the 
1/O area, when a work area is not specified, the following keyword parameter is 
required: 


VBLD=(r) 
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where (r) is the number of the register (2—12) into which logical IOCS places the 
number of bytes of residual space left in the current I/O area. Before building a 
record, the user is responsible for determining whether the residual space is large 
enough for the next record. If it is not, a TRUNC macro instruction must be issued 
to write out the current block, thereby making available the entire I/O area. 


m Work Area Processing 


If records in an input file are to be transferred from the input I/O area to a work 
area, the following keyword parameter must be specified: 


WORK=YES 


This keyword parameter must also be specified for output files when records are 
to be built in a work area. 


The user must specify the address of the current work area with each GET and 
PUT macro instruction. 
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Na FILES 
SPECIFICATION INPUT | OUTPUT REMARKS 


YES x x Performs writing or checking of 
block numbers 


n= maximum block size The maximum block size in bytes 


YES Checkpoint dumps, if present, on 
input files are bypassed 


NORWD No tape rewind after CLOSE 


RWD Rewind tape without interlock after 
CLOSE 


symbolic label Identifies end-of-file routine 
IGNORE Treat error block in input file normally 
SKIP Skip the block containing the error 


symbolic label Address of user routine to process 
unique errors 


symbolic label Address of user’s unrecoverable 
error routine 


stp ! For standard labeled files 


Ce NO For unlabeled files 
NSTD For nonstandard labeled files 
symbolic label Address of input/output area 


symbolic label Address of alternate input/output 
area 


(t) = general register Required if records are processed 
in the 1/O area and there are two 
1/0 areas or records are blocked 


symbolic labels of user’s Required for output files with 
label routine FLBL=NSTD 


Required for input files with 
FLBL=NSTD if no tape marks 
separate header labels from data 
blocks 


OPTION For specifying an optional file 
OPRW No tape rewind before OPEN (does not 


apply when READ = BACK is specified; 
NORWD is assumed) 





oa Table 3-1. Summary of Keyword Parameters for the DT FMT Macro Instruction 
(Part 1 of 2) 
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FILES 
SPECIFICATION INPUT | OUTPUT 


FIXUNB! 


FIXBLK 
VARBLK 
VARUNB 
UNDEF 


n= number of bytes in 
record 


(tr) = genera! register 


FORWARD! 


BACK 


NO 


INPUT 


OUTPUT 


INOUT 


(r) = general register 





LEGEND: 
R = Required 
X = Optional 


Y = One option required 


t+ = Assumed parameter, if none specified 
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REMARKS 


For fixed-length, unbtocked records; 
assumed by logical 10CS 


For fixed-length, blocked records 

For variable-length, blocked records 
For variable-length, unblocked records 
For undefined records 

For fixed-length, blocked records 

For undefined output records; register 
contains record size 


Optional for undefined input records; 
register contains record size 


Optional to read a tape forward 
Required to read a tape backward 


Write no tape mark for FLBL=NSTD 
or FLBL=NO 


For input files 
For output files 


For input/output files 


Required for variable-length, blocked 
records built in output area; register 
contains number of bytes left in output 
area 


Process records in work area 


Table 3-1. Summary of Keyword Parameters for the DTFMT Macro Instruction 
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Direct Access Storage Devices 


The declarative macro instruction, DTFSD, is required for input and output files 
processed in sequential order on the direct access storage subsystem. Following 
is a listing in alphabetic order of the required and optional keyword parameters 
which may appear in the operand of the DT FSD macro instruction. 


A description of the individual keyword parameters follows the listing. A summary 
of the keyword parameters is given in Table 3—2 following the descriptions. 


LABEL 6 OPERATION & OPERAND 


BKSZ=n 


EOFA=symbol (input files only) 
IOA1l=symbol 


[CNTRL=YES] 
8411 
DEVICE: < 8414 


filename 


IGNORE 
ERRO- SKIP 
symbol 
[ERROR=symbol] 
[I1OA2=symboll] 
[IORG -(r)] 
[LBAD=symbol] 
[OPTION=YES] 
FIXUNB 
FIXBLK 
RCFM- < VARBLK 
VARUNB 
UNDEF 


[Resz- (os | 


[ TRUNCS=YES] 
INPUT 
TYPE ourrurt 
INOUT 
[UPDT=YES] 
[VBLD=(r)] 
[VERIFY=YES] 
[WORK-YES] 








NOTE: Assembler rules concerning commas and continuation of parameters. in the 
operand field apply when writing this macro instruction; see 1.2. 


B Block Size 


This keyword parameter specifies the length of the I/O area and has the following 
format: 


BKSZ=n 


where n is the size of the block in bytes. If the records in the file are variable 
length, n is the maximum size for blocks in the file and must include the block 
and record length fields. 


NOTE: For all output files, n must be a multiple of the record size, plus eight 
bytes for the count field. 


8424 <_ 
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The value for n may not exceed 3625 bytes for UNIVAC 8411 Disc Subsystems, or 7294 
—> bytes for UNIVAC 8414 and UNIVAC 8424 Disc Subsystems (plus eight bytes for output oy 
files), 


a Control Entry 


If a CNTRL macro instruction is to be issued by a problem program, the following 
keyword parameter must be specified when the file is defined. 


CNTRL=YES 


When the CNTRL macro instruction is issued, a seek to the current track in the 
user’s file is generated. 


mw Device Type 


The type of direct access storage device upon which the data file resides may 
be specified by one of the following keyword parameters: 


8411 
DEVICE=< 8414 


—__ 8424 


where 8411 represents the UNIVAC 8411 Disc Subsystem, 8414 represents the 
UNIVAC 8414 Disc Subsystem, or 8424 represents the UNIVAC 8424 Disc 


Subsystem. 
This is not a required parameter; the OPEN transient routines determine the 
ae device characteristics from the Physical Unit Block (PUB) device type of the SY 


first volume. All other volumes of the file must be consistent with the first. 


m End of an Input File 


The address to which control is transferred, when the end of data is sensed, must 
be supplied by the following keyword parameter: 


EOF A=symbol 


where symbol (label) is the address of the user’s end-of-file routine. This is 
required for input files. 


m Unique File Errors 


A unique error is an unrecoverable parity error. If a unique error occurs when 
reading a block of data, the user has the following options: he may process 
the block as if no error had occurred, bypass the block, enter a special routine 
for individually processing error blocks, or terminate the job. The absence of 
this parameter specification will cause logical IOCS to assume that a job 
should be terminated if a unique error occurs. The other options are specified 
as follows: 


— ERRO=IGNORE 


This option permits the records in the block to be available to the user as 
though no error had occurred. 


— ERRO=SKIP 


This option causes the block in error to be bypassed and the next error-free 
block is read. This option should not be used for output files, or for input 
files with update mode (UPDT=YES). © 
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— ERRO=symbol 


we 
For this option, symbol (label) is the address of a user’s error routine to process 
any errors. When logical IOCS transfers control to the user’s error routine, reg- 
ister 14 contains the normal return address. Registers 2 through 12 are restored. 
Register 1 contains the address of the block in question for both input and output 
files. In addition, the following rules are observed: 
1. Do not destroy the present register save area (pointed to by register 13). 
2. Return with register 13 containing the save area address. 
3. Do not issue a GET or PUT instruction on the file. 
4. Access the record by means of register 1. 
5. Use another save area for any other IOCS file. 
6. Return by transferring control to the address contained in register 14. 
m Major File Error 
When a fatal hardware or detectable logical error occurs on a file, the user may 
have control transferred to a special error handling routine by specifying the 
following keyword parameter: 
ERROR=symbol 
where symbol (label) is the address of the error handling routine. When logical 
4 


IOCS transfers control to the routine, registers 1 through 12 are restored. If 
control is passed to the ERROR address from a processing macro instruction 
(such as GET and PUT), the address of the instruction following the macro 
call can be found in register 14. Register 14 is restored to the value in the 
register preceding the transient call (OPEN, CLOSE and FEOV). Register 0 
contains the following information concerning the reasons for the error: 


— Bytes 0 and 1 reflect the first and second hardware sense bytes if the error 
is a hardware error; otherwise, these bytes contain binary zeros. 


— Byte 2 contains a one-character EBCDIC value indicating in what section of 
processing the error occurred, where 4 = transients and 1 = processing. 


— Byte 3 contains a one-character EBCDIC value indicating the reason for the 
error; refer to Appendix E. 


Transient routines also cause an informational typeout, inserting bytes 2 and 3 
as xx in the standard Data Management message format (DMxx). If this keyword 
parameter is not specified, abort procedures are executed when a major file 
error occurs, but the console typeout still appears. 


Further access of the file is not permitted after a major file error has occurred. 
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m@ Input/Output Area 


Each input or output file must have an area reserved for its individual use. The eel 
area must be defined by the following keyword parameter. 
} IOA1=symbol 
where symbol (label) is the address of the I/O area. The length of the area is 
specified by the keyword parameter BKSZ. The I/O area must be defined asa 
multiple of the record size plus, for output files, the count field consisting 
N of the first eight bytes of the area (see 2.3.9). 
a Secondary Input/Output Area 
A secondary I/O area for standby processing improves efficiency by overlapping 
I/O and record processing time. The format of the keyword parameter for a secondary 
I/O area is: 
IOA2=symbol 
where symbol (label) is the address of the secondary I/O area. It is subject to 
the same requirements as noted in IOAI. 
m Current Record Pointer 
When a general register is used as an index register to reference current data, 
the following keyword parameter should be specified: 
IORG=(r) 
where (r) is the number of the general register (2-12). If a work area is not re- a 


quired, this keyword parameter must be specified when there are two I/O areas 
or records are blocked. 


For input files, logical IOCS places the address of the next available record in 
the specified register, 


For output files, logical IOCS places in the specified register the address of 
the next available I/O output area. 


m Special Label Handling 


This keyword parameter supplies the address of a user routine which processes 
user standard labels (UHLn/UTLn). This format is: 


LEAD=symbol a 


where symbol (label) is the address of the user routine. 


During the processing of the OPEN macro instruction, the user receives control 
after the header label has been checked on an input file or after the header label 
has been written on an output file. 
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For both input and output files, logical IOCS places the EBCDIC character O, 
Ne denoting OPEN, in the low order byte of register 0, and places the address of the 
I/O area in register 1. The input data pointed to by the address in register 1 is 
available for processing; labels for output files can be built in the I/O area 
pointed to by register 1. The special label handling routine must return control 
to logical IOCS by means of the LBRET macro instruction with the proper option 
specified (see 3.3.7). Logical IOCS completes the processing of the OPEN macro 
instruction and prepares the file for the first GET or PUT macro instruction. 


For user trailer labels, after reading or writing the end-of-file record or reaching 
the end-of-volume address and before transferring control to the special label 
handling routine, logical IOCS loads the EBCDIC character V or F, whichever 
is applicable, into register 0. The conventions regarding the use of the LBRET 
macro instruction are the same as those for processing the user header labels. 


After an end of volume has been reached, logical IOCS transfers control to the 
special label handling routine with the address of the I/O area (IOA1) in register 1. 


User header and trailer labels are read into IOA1. On input, register 1 always 

points to the proper area (IOA1) into which the label has been read. On output, 
register 1 always points to the area (IOA1) into which the user is expected to 

place the label to be written. The label is moved and written from the transient 

area. Since the length of a user label (UHL1—8 or UTLO—7) is always 80 characters, 
IOA1 must be 80 characters minimum or needed data may be destroyed. 


In processing multiple labels, note that user label handling procedures are enter- 
ed at the LBAD address for each label, and that LBAD is the same for both 
header and trailer labels. The user must, therefore, expect to identify the label 
being processed. (Use of the LBRET (2) macro instruction does not imply that 
control is returned following the LBRET (2) instruction, but that return is made 
at the LBAD address.) Each time LBAD is entered, the registers (other than 0 
and 1) are set as they were when the appropriate macro call (PUT, TRUNC, 
OPEN, CLOSE, or FEOV), which resulted in label handling procedures being 
instituted, was issued. The user is, therefore, cautioned not to save any informa- 
tion in a register which he may require at the next entry to LBAD, or upon return 
to inline user coding. The table in Appendix A.2 indicates the conditions and 
requirements for label procedures. 


After an end of file has been reached, logical IOCS transfers control to the user’s 
end-of-file routine (EOFA), The end-of-file routine should issue a CLOSE macro 
instruction for the file. During the processing of the CLOSE macro instruction, 
logical IOCS transfers control to the special label handling routine if there are 
other user trailer labels. 


m Optional Input File 


The keyword parameter to allow the user to specify an optional input file follows: 


OPTION=YES 


When this keyword parameter is specified and the file has not been allocated to 

a device by Job Control, the OPEN transient routine ensures that logical IOCS 
transfers control to the address of the user’s end-of-file routine (EOFA) following 
the execution of the first GET macro instruction. This procedure maintains contin- 
uity in the user’s program. The user is required to CLOSE the optional file. 
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When this keyword parameter is not specified and the file has not been allocated 
by Job Control, it is impossible to obtain records from the file. Logical IOCS 
transfers control to the address of the user’s error routine (ERROR). If a user 
error routine is not supplied, the job is aborted. 


@ Record Format 


The record format of a disc file is specified by a keyword parameter. There are 
five options to indicate whether the records are fixed length, variable length, 
blocked, unblocked, or undefined. The options are coded as follows: 


— RCFM=FIXUNB Fixed-length, unblocked 

— RCFM=FIXBLK Fixed-length, blocked 

— RCFM=VARUNB Variable-length, unblocked 
— RCFM=VARBLK Variable-length, blocked 
— RCFM=UNDEF Undefined 


Logical IOCS assumes a fixed-length, unblocked record format when this keyword 
parameter is not specified. 


mB Record Size 


The number of bytes in a record is made available to logical IOCS by specifying 
this keyword parameter. Logical IOCS assumes that the record size is equal to 

the block size for fixed-length, unblocked records and that the size of the record 
is available in the first two bytes of each variable-length record. 


— RCSZ=n 


This form of the keyword parameter should be used for fixed-length, blocked 
records, where n is the number of bytes in the record. 


— RCSZ=(r) 


This form of the keyword parameter is required for output files with undefined 
record formats. The general register (2-12) specified by (r) must contain the 
block length. 


The keyword parameter may also be used for input files with undefined records. 
Logical IOCS places the block length into the. general register specified by (1). 


m Short Blocks 


The following keyword parameter is provided only for purposes of compatibility 
with comparable systems: 


TRUNCS=YES 
Logical IOCS is always prepared for the possibility of short blocks on an input 


file of fixed-length blocked records, or for output files of either fixed- or variable- 
length blocked records. 
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mw Type of File 


Ne The type of file is specified by this parameter. 
— TYPE=INPUT 


This keyword parameter specifies an input file (one that is to be read), This 
option is assumed if this keyword parameter is not specified. 


- TYPE=OUTPUT 


This keyword parameter specifies an output file (one that is to be written). 


— TYPE=INOUT 


This keyword parameter specifies a file which can be used as either an output 
or an input file. 


The user expects the file to be an output type first; the DTF is set up accord- 
ingly. After the use of the file as an output type, the user changes to an input 
file by resetting the DTF File Type indicator (bit 7 of DC$FG1) and by decre- 
menting the block size by 8 in DC$BKS before reopening the file. DTFD with 
SD=YES must be included in the program (see 1.5.1). 
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The significance of the file-type indicator bits (bits 6 and 7 of DC$FG1) 
follows: 
Bit 6 Bit 7 
0 0 Input file 
te 0 1 Output file 
1 0 Input file with update 


1 1 Not used (invalid) 
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Users with file updating (UPDT=YES) requirements must specify the UPDT 
keyword parameter to ensure the inclusion of the correct modules. 


m File Updating 


When an input file on a direct access storage device is to be updated, the follow- 
ing keyword parameter must be specified, 


UPDT=YES 


Each record is read, modified if necessary, and if modified then written back into the 
same Storage location. This applies only to input or inout files. 


@ Variable-Length Record Residual Space 


For output files with variable-length blocked records to be processed in the I/O 
area and a work area is not specified, the following keyword parameter is required: 


VBLD=(r) 


where (r) is the number of the register (2—12) into which logical IOCS places the 
number of bytes of residual space left in the current I/O area. Before building a 
record, the user is responsible for determining whether the residual space is 
large enough for the next record, If it is not, a TRUNC macro instruction must 
be issued to write out the current block, thereby making available the entire I/O 
area, 


m Write Verification 


When records should be check-read after they have been written, the following 
keyword parameter should be specified: 


VERIFY=YES 


When both the UPDT=YES and TYPE=INPUT parameters are specified, the 
VERIFY option may be chosen to check-read the updated records. 


Data Management reads back one byte of data and checks for a successful completion 
thus verifying that the record transferred was written correctly. The hardware cyclic 
check feature establishes if the transfer was completed successfully. Verification of 
records necesSarily increases the execution time for the commands associated with 
the WRITE macro instruction. 


m Work Area Processing 


If records in an input file are to be transferred from the input I/O area to a work 
area, the following keyword parameter must be specified. 


WORK=YES 


This keyword parameter must also be specified for output files when records are to 
be built in a work area. 


The user must specify the address of the current work area with each GET and 
PUT macro instruction. 
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NOTE For output files, BKSZ in this example must equal 808 to include the 
eight-byte count field. 
FILES 
INPUT OUTPUT REMARKS 
ad n= maximum block size The maximum block size, in bytes 
YES A CNTRL macro will be issued 
for the file. 
8411, 8414, or 8424 Identifies the direct access storage 
device 
symbolic label Identifies EOF routine 
IGNORE Treat error block in input file normally, 
On output, VERIF Y=YES is specified. 
SKIP Skip the block containing the error 
symbolic label of user’s User handles the block in error. On 
error routine output, VERIFY=YES is specified. 
symbolic label Address of user’s unrecoverable error 
routine 
symbolic label Address of input/output area 
symbolic label Address of alternate input/output area 
(r) = general register Required if records are processed in 
the I/O area and there are two 1/0 
ateas or records are blocked 
LEGEND: 
4 
R = Required Y = One option required 
X = Optional t+ = Assumed parameter, if none specified 


Table 3~2. Summary of Keyword Parameters for the DT FSD Macro Instruction 
(Part 1 of 7) 
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KEY- FILES 


ees ae ee 
WORD INPUT OUTPUT 
x 
x 
x 
Y 
Y 
Y 
Y 
x 





LBAD symbolic label of user’s xX 


label routine 


OPTION YES 


RCFM FIXUNBT 


FIXBLK Y 
VARBLK Y 
VARUNB Y 
UNDEF Y 
RCSZ n = number of bytes in xX 
record 
(t) = general register x 
xX 
TRUNCS YES Xx 
xX 
TYPE INPUT! x 
OUTPUT R 


INOUT 


YES 


(r) = general register 


VERIFY 
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REMARKS 


Required if user header or trailer labels 
are to be created 


Required if user header or trailer labels 
are to be checked 


For specifying an optional file 


For fixed-length, unblocked records; 
assumed 


For fixed-length, blocked records 

For variable-length, blocked records 
For variable-length, unblocked records 
For undefined records 

For fixed-length, blocked records 

For undefined output records; register 
contains record size 


Optional for undefined input records; 
register contains record size 


For use if a fixed-length, blocked 
disc file contains short blocks 


For use if short blocks are to be 
written for a fixed-length, blocked 
record of a disc file 


For input files; assumed 
For output files 


For input/output files 


This parameter is required if records 
are to be written back to the same location 
from which they were read 


Required for variable-length, blocked 
records built in output area; register 
contains number of bytes left in output 
area 


Check parity after records have been 
written 


Process records in work area 


LEGEND: 
R = Required Y = One option required 
X = Optional t = Assumed parameter, if none specified 


Table 3~2. Summary of Keyword Parameters for the DTFSD Macro Instruction 


(Part 2 of 2) 
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Card Device 


The declarative macro instruction, DTFCD, is required for card input and output 
files. It serves the UNIVAC 9000 Series 600 cpm Reader, Type 0711, the 600/1000 
cpm Reader, Type 0716, and the Row Punch Subsystem, Type 0604. Following is a 
listing in alphabetic order of the required and optional keyword parameters which may 
appear in the operand of the DTFCD macro instruction. 


A description of each keyword parameter follows the listing. A summary of the keyword 
parameters is given in Table 3—3 following the descriptions. 


LABEL 6 OPERATION 6 OPERAND 


BKSZ=n 
EOFA=symbol (Input files only) 
IOA1=symbol 


filename 


ol 
MODE- (Sr 

yee | 

reas 
RCFM=< UNDEF 

vasana 
STUB= ee sf 

( COMBND | 
TYPE-< INPUT 

ourpuT J 

[AUE=YES] 


[CNTRL:YES| 
([CTLCHR=YES] 
[ ERROR=symbol] 
{1OA2~symbol] (Required for combined files) 
([IORG=(r)] 
{ITBL=symboll] 
{OBSZ=n] 
[ORLP- YES] 
{OPTION=YES|] 
[OTBL=symbol] 
[PUNR=YES] 
[RCSZ-=(r)] 
(WORK: YES] 





NOTE: Assembler rules concerning commas and continuation of parameters in the 
operand field apply when writing this macro instruction; see 1.2. 


PAGE: 
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g Validity Check a 


This keyword parameter is to be used only with card input files (TYPE=INPUT) 
and specifies that data cards that fail the hardware ‘‘validity check”’ are to be 
ignored. Validity check is an optional hardware feature which must be present 
in the hardware in order to use this keyword parameter. The format is: 


AUE=YES 


The validity check detects the presence of more than one punched hole in the 
numeric rows 1 through 7 of any card column during reading of 80-, 66- or 51- 
column cards in the hardware translate (EBCDIC) mode. This mode is determined by 
specifying the keyword parameter MODE=STD. 


If the reader is a Type 0716, this specification also sets up the hardware to 
function in the SORT-ON-ERRORS mode, in which case all error cards at the 
completion of reading are sorted into the reject stacker. 
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m Block Size 


This keyword parameter specifies the length of the I/O area and has the following 
format: 


BKSZ=n 


where n is the size of the block in bytes. If the records in a file have an undefined 
format, then n specifies the size of the largest record. 


When the 51- and 66-column stub card read feature is used, the block size must 
be specified correctly. A block size that is larger than the number of columns in 
the cards causes transmission of erroneous data. A smaller block size may be 
specified if all columns are not used. 


If this keyword parameter is omitted, the block size (80 or 160) is determined by the 
keyword parameter MODE. 


m Control Entry 


If a CNTRL macro instruction is to be issued by a problem program, the following 
keyword parameter must be specified when the file is defined. 


CNTRL=YES 


Use of the keyword parameter indicates that a CNTRL macro instruction to be 

issued for stacked selection on the UNIVAC 0604 Card Punch Subsystem. To <_ 
select the stacker for a particular card, the CNTRL macro instruction that selects 

the stacker must be issued after the PUT macro instruction that punched the card 

or it must precede the PUT macro instruction that delivers the card from the 

postread station to the selected stacker. 


This keyword parameter is also used if the unit is to operate in the read/punch | 
mode. When operating in the read/punch mode with or without overlap, each 

CNTRL macro instruction issued must correspond to a GET or a PUT macro 
instruction. The CNTRL macro instruction can be issued after the GET or PUT 
macro instruction that reads or punches the card to be controlled, or it can be 

issued before the GET or PUT macro instruction that delivers the card from the 
post-read station to the selected stacker. 


The CNTRL macro instruction does not apply to input files on the 600 cpm reader. 


If the first character control (CTLCHR=YES) or punch recovery (PUNR=YES) is 
specified for an output file, the CNTRL keyword parameter must not be specified. 


@ First Character Control 


The following keyword parameter must be specified when a control character is 
to be used in data records. 


CTLCHR=YES 


However, this parameter does not apply to input or combined files. Also, punch 
recovery (PUNR=YES) should not be specified when a control character is used. 

If the CTLCHR keyword parameter is specified, every record in the file must 

contain a control character. The character is normally used for stacker selection 

on the UNIVAC 0604 Card Punch Subsystem. Command codes for the punch <_ 
are as follows: 
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OxcdetO1 (Write) 
Oxcdex11 (Device Control) 
where: 
c=l1 Feed a card and select stacker. The card that was punched on 


the previous punch order is placed in the selected stacker. 


d=1 Feed and punch a card. 
e=1 Feed a card. 

f=0 Write in compressed mode. 
f=1 Write in image mode. 

x Ignored by the control unit. 


m End of an Input File 


The address to which control is transferred when the end-of-data card is sensed 
must be supplied by the following keyword parameter: 


EOF A=symbol 


where symbol (label) is the address of the routine which handles end-of-data pro- 
cessing. This keyword parameter is required for all input and combined files. 


w Major File Error 


When a fatal hardware or detectable logical error occurs on a file, the user may 
have control transferred to a special error handling routine by specifying the 
following keyword parameter: 


ERROR=symbol 


where symbol (label) is the address of the error handling routine. When logical 
IOCS transfers control to the routine, registers 1 through 12 are restored. If 
control is passed to the ERROR address from a processing macro instruction 
(such as GET and PUT), the address of the instruction following the macro 

call is found in register 14, Register 14 is restored to the value in the register 
preceding the transient call (OPEN and CLOSE). Register 0 contains the follow- 
ing information concerning the reasons for the error: 


— Bytes 0 and 1 reflect the first and second hardware sense bytes if the error 
is a hardware error; otherwise, these bytes contain binary 0’s. 


— Byte 2 contains a one character EBCDIC value indicating in what section of 
processing the error occurred, where 4 = transients and 1 = processing. 


— Byte 3 contains a one character EBCDIC value indicating the reason for the 
error; refer to Appendix E. 


Transient routines also cause an informational typeout, inserting bytes 2 and 3 
as xx in the standard Data Management message format (DMxx). If this keyword 
parameter is not specified, abort procedures are executed when a major file 
error occurs, but the console typeout still appears. 
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@ Input/Output Area 


Each input or output file must have an area reserved for its individual use. The 
area must be defined by the keyword parameter. 
IOA1=symbol 
where symbol (label) is the address of the I/O area. This keyword parameter 
specifies the input area for a combined file. 
m Secondary Input/Output Area 
A secondary I/O area for standby processing may be specified by the following 
keyword parameter: 
IOA2=symbol 
where symbol (label) is the address of the secondary I/O area. This keyword 
parameter specifies the output area for a combined file. 
a Current Record Pointer 
When a general register is used to reference current data, the following keyword 
parameter is specified: 
IORG=(r) 
where (r) may be general registers 2 through 12. The register must be specified 
if two I/O areas are used, if records are not to be processed in a work area, and 
os if the file is not combined. 
For input files, logical IOCS places the address of the next available record in 
the specified register. 
For output files, logical IOCS places the address of the next available I/O output 
area in the specified register. 
a Input Translation Table 
Where records in a combined file are to be translated, the following keyword parameter 
is specified 
ITBL=symbol 
where symbol (label) is the address of the translation table in the problem pro- 
gram. If the keyword parameter MODE=TRANS is specified, the keyword parameter 
ITBL must also be specified. 
mw Input/Output Mode 
This keyword parameter is used to specify the input/output mode of the file and is 
required as part of the DIFCD macro instruction. There are four forms of the key- 
word parameter which can be used with the two card devices. 
— MODE=BINARY 
ee This form is used for cards read on the 600 cpm Reader, Type 0711, or the 600/ 


1000 cpm Reader, Type 0716, in column binary mode or for cards read or punched 
on the Row Punch Subsystem, Type 0604, in column binary (image) mode. An I/O 
area of 160 bytes is required. The card code image is untranslated. 
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— MODE=STD 


On the 600 cpm Reader, Type 0711, or the 600/1000 cpm Reader, Type 0716, 
when cards are to be read with hardware translation, this form should be 
specified. The hardware translation is to EBCDIC code. This option is 
assumed if this keyword parameter is not specified. 


On the Row Punch Subsystem, Type 0604, when cards are read in compressed code 
and translated to EBCDIC code or when cards are translated from EBCDIC code 
and punched in compressed code, this form should be specified. 


—- MODE=CC 


On the Row Punch Subsystem, Type 0604, this form must be specified for cards 
read or punched in compressed code without translation. An I/O area of 80 bytes 
is usually required. 


— MODE=TRANS 


On the Row Punch Subsystem, Type 0604, this form should be specified for 
cards read or punched in compressed code and translated by the table specified 
by the ITBL or OTBL keyword parameter, respectively. 


a Output Block Size 


For a combined file, the length of the secondary I/O area (IOA2) is specified by 
the following parameter: 


OBSZ=n 


where n is the length, in bytes, of the area. If IOA2 is specified and OBSZ is 
omitted, the size of the output block is assumed to be the same length as BKSZ. 


m Overlap 


When the Row Read/Punch unit is to be processed in an overlap mode, the follow- 
ing keyword parameter should be specified: 
/ 


ORLP=YES 


The preread feature enables the punch to preread cards. If the information read 
during the previous cycle is to be ptocessed, it is necessary to transfer the 
information from the preread buffer before issuing another punch order. A GET 
macro instruction issued for the file initiates the reading of the next card as 
well as transferring the previous card image from the buffer to the user input 
I/O area. 


Where overlap is not specified, a GET macro instruction causes a transfer, or 
a transfer and translate, of the input record. A PUT macro instruction causes 
a transfer of the output image from the output I/O area to the punch buffer and 
then to the card, or it causes a transfer with translation from the output I/O 
area to the buffer and then from the buffer to the card. 


In the overlap mode, each GET and PUT macro instruction causes the read/punch 
unit to advance one card. Without overlap, the unit advances one card on PUT 
macro instructions and also when one GET is followed by another GET macro 
instruction. 


32 


UP-7629 UNIVAC 9400 * 


Rev. 2 DATA MANAGEMENT SYSTEM SECTION: PAGE: 





Three possible combinations for issuing GET and PUT macro instructions with 
NN overlap specified are explained in the following paragraphs. 


— Alternating GET and PUT macro instructions when used with alternating pre- 
punched and blank cards produce valid results if each GET macro instruction 
applies to prepunched input data cards and if each PUT macro instruction 
applies to punching data into a blank card. 


— Multiple GET macro instructions between single PUT macro instructions when 
used with multiple prepunched cards between single blank cards produce valid 
results if, in every case, the number of GET macro instructions corresponds to 
the number of prepunched cards between each of the blanks that the PUT macro 
instructions references. 


— Multiple GET and multiple PUT macro instructions when used with multiple 
prepunched cards between multiple blanks produce valid results if the number 
of GET macro instructions and PUT macro instructions and the number of pre- 
punched and blank cards are consistent through the program, 


Out-of-order records in the data file produce errors. 


@ Optional Input File 


Some users may wish to define files for which at some specific run time no data 

exists; for example, when he may desire to issue change notices against a master 

file. In this case, he could specify an optional input file. The keyword parameter 
<A that allows the user to specify an optional input file follows: 


OPTION=YES 


When this keyword parameter is specified and the file has not been allocated to 

a device by Job Control, the OPEN transient routine ensures that logical IOCS 
transfers control to the address of the user’s end-of-file routine (EOFA) following 
the execution of the first GET-macro instruction. This procedure maintains cone 
tinuity in the user’s program. The uSeris required to CLOSE the optional file. 


When this keyword parameter is not specified and the file has not been allocated 
“by Job Control, it is impossible to obtain records from the file. Logical IOCS 
transfers control to the address of the user’s error routine (ERROR). If a user 
error routine is not supplied, the job step is aborted. 


@ Output Translation Table 


When records in an output or combined file are to be translated, the following 
keyword parameter is specified: 


OTBL=symbol 


where symbol (label) is the address of the translation table in the problem program. 
A translation table is required if the keyword parameter MODE=TRANS is specified. 


@ Punch Error Recovery 


NS ey If a card punch error recovery should be attempted, the following keyword parameter 
should be specified: 


PUNR=YES 
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Error cards are automatically selected into the Error Select Stacker. If error re- 2 
covery is not successful, logical IOCS returns control to the address of the user’s re 
error routine (ERROR). The user can access the card image by means of the address 

found in filenameS in the DTFCD table. If PUNR and ERROR are not specified, 

logical IOCS assumes that the job must be terminated when a punch error (hole 

count error) is encountered. 


Error recovery is not possible with combined reading and punching. Also, the 
CNTRL=YES or CTLCHR=YES parameters cannot be specified when punch error 
recovery is specified. 


@ Record Format 


One of the three following options describing the record format should be specified. 


— RCFM=FIXUNB 


Fixed-length records for input and combined files are assumed by logical IOCS 
when this keyword parameter is omitted. 


— RCFM=UNDEF 
This form is used for undefined records in output files only. 
— RCFM=VARUNB 
This form is used for variable-length, unblocked records in output files only. 
m Record Size al 


For output files with undefined record format, the following keyword parameter 
is specified: 


RCSZ =(r) 


where (r) indicates the number (2—12) of the general register that holds the size 
of the output record. The record size must be entered into the general register 
before the PUT macro instruction is issued. 


@ Stub-Cards 


One of the following options describing the size of the stub card should be specified 
if the stub card feature has been installed on the 600/1000 cpm Reader, Type 0716. 


The keyword parameter MODE=STD must be specified. 


— STUB=51 


This option describes a stub card of 51 columns as input from the 600/1000 cpm 
Reader, Type 0716, 


— STUB=66 


This option describes a stub card of 66 columns as input from the 600/1000 cpm 
Reader, Type 0716, 


a Type of File 


The type of file must be specified by one of the following three keyword parameters. 







UP-7629 
Rev. 2 







UNIVAC 9400 
DATA MANAGEMENT SYSTEM 





3 35 





SECTION: PAGE: 


— TYPE=INPUT 


NL This option describes an input file from the 600 cpm UNIVAC 0711 Card Reader 
Subsystem, or the 600/1000 cpm UNIVAC 0716 Card Reader Subsystem. This ‘ 
option is assumed if this keyword parameter is not specified. 


-— TYPE=OUTPUT 
This option describes an output file for the UNIVAC 0604 Card Punch Subsystem. 


NOTE: When an output card file is closed, a /* card will be punched as the last data 
card for the file in the mode of the file. 


— TYPE=COMBND 4 


This option describes the combined file of the UNIVAC 0604 Card Punch Subsystem 
<~ 
when the read/punch feature is to be used. 


m Work Area Processing 


If a work area is required in which to process I/O records rather than processing 
the records in the I/O area, the following parameter is specified: 


WORK=YES 


The address of the current work area must be specified with each GET or PUT 
macro instruction. 
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AUE 
BKSZ 


CNTRL 


CTLCHR 


EOFA 


ERROR 


10A1 


1OA2 


IORG 


LEGEND: 
R = Required 
X = Optional 
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SPECIFICATION 


YES 
n= maximum block size 


YES 


YES 


symbolic label 


symbolic label of 


user’s error routine 


symbolic label 


symbolic label 
(t)= general register 


(2~—12) 


symbolic label 


BINARY 


cc 


Y = One option required 








FILES 


NPUT | OUTPUT | COMBND 
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REMARKS 


Mispunched cards accepted 


The maximum block size in bytes 


Specify if CNTRL macro is issued 
to file; CTLCHR must be omitted 


For First Character Control; CNTRL 
must be omitted 


End-of-file routine for input and 
combined files 


Address of the user’s unrecoverable 
error routine 


Address of input/output area; input 
atea for a combined file 


Address of alternate input/output 
area; output area for a combined file 


General register that contains the 

address of the current record when 
processing in two I/O areas. Omit 

WORK=YES. Must not be used for a 
combined file 


Address of input translate table 


Specifies cards are to be read or 
punched in column binary 


Specifies cards are to be read or 
punched in compressed code 


Automatically translates from come 
pressed code to internal code and 
vice versa 


For cards to be read in or punched 
in compressed code and translated 
by the table specified in the ITBL 
or OTBL entry, respectively 


Table 3-3. Summary of Keyword Parameters for the DTFCD Macro Instruction 


(Part 1 of 2) 














UNIVAC 9400 


SPECIFICATION 


OBSZ n=length of |OA2 


ORLP YES 


OPTION YES 


OTBL symbolic label 


PUNR YES 


RCFM FIXUNB 
UNDEF 
VARUNB 


(r)= general register 
(2-12) 


51 

66 
COMBND 
INPUT 
OUTPUT 


YES 


LEGEND: 
R = Required 
X = Optional 


Y = One option required 


DATA MANAGEMENT SYSTEM 


FILES 


INPUT 


OUTPUT | COMBND 
R 
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REMARKS 


Specifies the length of |OA2 for a 
combined file 


Specifies that a read/punch unit file 
is to be processed in an overlap mode 


Specifies an optional file 
Address of output translate table 


Automatic punch error recovery 
(not specified with combined files) 


For fixed-length records 
For undefined records 
For variable-length records 


For undefined records, register 
contains record size 


For 5l1-column cards only 


For 66-column cards only 


For combined read/punch file 


For input files 
For output files 


Records are to be processed in 
work area 


Table 3-3. Summary of Keyword Parameters for the DTFCD Macro Instruction 
(Part 2.of 2) 


3.2.4. Printer 


The declarative macro instruction, DTFPR, is required for each printer file processed 
in the program. It serves the UNIVAC 9000 Series 900/1100 LPM Drum Printer, Type 
0768-00 and Type 0768-01, as well as the line printers furnished with the 1004/1005 
Subsystems. Refer to Table 3—4 for a listing of the pertinent differences between 

the two types of printers. Following is a listing in alphabetic order of the required 
and optional keyword parameters which may appear in the operand of the DTFPR 


macro instruction, 


A description of each keyword parameter follows the listing. A summary of the keyword 
parameters is given in Table 3—5 following the descriptions. 
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LABEL Bb OPERATION & OPERAND 


BKSZ=n 
IOA1l=symbol 
FIXUNB 
RCFM= <UNDEF 
VARUNB 
[AUE-YES] 
[CNTRL-- YES] 
[ CODE=symbol] 
[CTLCHR=YES] 
{ERROR=symbol] 
[IOA2::symbol] 
[1ORG=(1)] 
[PRAD=n] 


[PRrov- — 
symbol 


[RCSZ=(1)] 
[WORK=YES] 


filename 





NOTE: Assembler rules concerning commas and continuation of parameters in the 
operand field apply when writing this macro instruction; see 1.2. 


@ Character Mismatch 


This keyword parameter and the following format allows the user to ignore a 
character mismatch: 


AUE=YES 


A mismatch occurs whenever the printer attempts to print a bit configuration 
which is not present in the printer’s load code buffer. All unprintable characters 
are printed as the nonprinting code (NP) in the load code buffer. (When the 
standard load code, Table 3-6, is used, a blank space (4016) is printed.) 


a Block Size 


This keyword parameter and the format specifies the length of the I/O area: 


BKSZ=n 


where n is the size of the block in bytes. If the record format is undefined, 
n specifies the size of the largest record. 


If this keyword parameter is omitted, the assumed size of the block is determined 
by the RCFM and CTLCHR parameter specifications. (BKSZ may be a maximum 
of 141 bytes when CTLCHR=YES and RCFM=VARUNB.) 


a Control Entry 


The following keyword parameter is specified if spacing or skipping of lines on 
the printer is controlled from the problem program by the CNTRL macro instruction. 


CNTRL=YES 


The form on the printer is under the control of the paper tape carriage-control loop. 
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m@ Printer Code Conversion 


— A printer code conversion table is required by the printer control unit. The user 
has the option of supplying his own code conversion table by specifying the 
following keyword parameter: 


CODE=symbol 


where symbol (label) is the address of the user’s code conversion table located 
within the problem program. The table requires 64 bytes and the sequence of 
loading must be in accordance with Table 3-6. When an OPEN macro instruction 
is issued for a print file, the user’s code conversion table is loaded into the 
64-byte printer buffer area for use. 


If the keyword parameter is omitted, the Standard Printer Code Conversion Table 
(Table 3—7) as loaded by Job Control into the 64-byte print buffer area is effective. 


The complete 63-character type font is repeated, in a checkerboard pattern, around 
the circumference of the drum for each of the 132 print positions. A complete 63- 
character set can be printed in one full revolution of the drum. Any subset of 49 
contiguous characters is printed in about 78% of one drum revolution. The faster 
printer can print any subset of 43 contiguous characters in about 68% of one rev- 
olution. 


Printing of a line begins as soon as the print line buffer has been filled and is 

independent of the position of the rotating drum. Printing continues until all 

characters for the line have been printed, a condition recognized by an ‘‘end print’’ 

detector. Consequently, both the beginning and the ending of the actual printing of 
as a line occur with the drum in varying angular positions. 


a First Character Control 


The following keyword parameter must be specified when a control character is to 
be used in data records. 


CTLCHR=YES 


If the keyword parameter is specified, every record in the file must contain a control 
character. The control character is used to space over a specific number of lines 

or to skip to a specific location on the form. Command codes for the printer are as 
follows: 


Ocdef001 (Print) 


Ocdef011 (Control — advance, no print) 
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The meaning of the values for c,d, e, and f singly and in combination are: - 
c d e f Meaning ee 
0 0 O 0 No advance 
0 0 0 1 = Advance one line 
0 0 1 #O Advance two lines 
0 0 1 #1 # Advance three lines 
0 1 #0 OO Paper is advanced under control of the Forms Control tape 


the loop. 


Print Character Differences. 


HEX CODE seine CHACA CHER 
4A ¢ (CENTS SIGN) 
4F | (ABSOLUTE) 
5F (LOGICAL NOT) 
6D — (UNDERSCORE) 
7F "" (QUOTE) 


Skip/Code Conversion Table 





loop to the line corresponding to the hole combination in 


1004 PRINTER CHARACTER 


A (DELTA) 

{ (LEFT BRACKET) 

# (NOT EQUAL) 

HM (LOZENGE) 

] (RIGHT BRACKET) / 


COMMAND FOR TYPE 0768 PRINTER COMMAND FOR TYPE 1004 PRINTER 


NO SPACE 
SPACE 1 LINE 
SPACE 2 LINES 
SPACE 3 LINES 


SKIP 4 

SKIP 5 

SKIP 6 

SKIP 7 

SKIP 8 

SKIP 9 (FORM OVERFLOW) 
SKIP 10 : 
SKIP 11 

SKIP 12 

SKIP 13 : 
SKIP 14 (HOME PAPER 6 LPI) 
SKIP 15 (HOME PAPER 8 LP!) 


LOAD CODE 





NO SPACE 

SPACE 1 LINE 
SPACE 2 LINES 
SPACE 3 LINES 


SKIP 2 

SKIP 3 

SKIP 4 

SKIP 5 

SKIP 6 

SKIP 1 (FORM OVERFLOW) 
NO FORM ADVANCE TAKES PLACE 
WITH THESE SKIP OPTIONS FOR * 
EITHER A WRITE OR A CONTROL 
COMMAND. 

SKIP 7 (HOME PAPER) 

SKIP 7 (HOME PAPER) 


NO OPERATION 


Table 3-4. Differences Between UNI VAC 0768 and 1004/1005 Printers 
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aa If this keyword parameter is specified, then the keyword parameter CNTRL=YES 
NL should not be specified. 


— Home Paper Code 


By programming conventions, the code 111f in the Forms Control tape loop is 
reserved for home paper. It requires no special recognition in the control unit. 
The f bit is used to control whether the spacing is six or eight lines per inch. 


When f=0, space six lines per inch. 


When f=1, space eight lines per inch. 


— Form Overflow 


The code 1001 in the Forms Control tape loop is reserved to specify an end of 
form. 


Response to form overflow is a function of the number of I/O areas and work areas 
assigned and may be illustrated as follows: 


WORK 
IOA1 IOA2 AREA REMARKS 


One line printed after overflow is detected 
overflow action follows 






Two lines printed after overflow is detected 
overflow action follows 





@ Major File Error 


When a fatal hardware or detectable logical error occurs on a file, the user may 
have control transferred to a special error handling routine by specifying the 
following keyword parameter: 


ERROR=symbol 


where symbol (label) is the address of the error handling routine. When logical 
IOCS transfers control to the routine, registers 1 through 12 are restored. If 
control is passed to the ERROR address from a processing macro instruction 
(such as GET and PUT), the address of the instruction following the macro call 
is found in register 14. Register 14 is restored to the value in the register pre- 
ceding the transient call (OPEN and CLOSE). Register 0 contains the following 
information concerning the reasons for the error: 


— Bytes 0 and 1 reflect the first and second hardware sense bytes if the error 
is a hardware error; otherwise, these bytes contain binary 0’s. 
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SECTION: 


~ Byte 2 contains a one character EBCDIC value indicating in what section of 
processing the error occurred, where 4 = transients and 1 = processing. oe 


~— Byte 3 contains a one character EBCDIC value indicating the reason for the 
error; refer to Appendix E. 


Transient routines also cause an informational typeout, inserting bytes 2 and 3 as 
xx in the standard Data Management message format (DMxx). If the keyword para- 
meter is not specified, abort procedures are executed when a major file error 
occurs; the console typeout still appears. 


w Input/Output Area 


Each input or output file must have an area reserved for its individual use. The 
area must be defined by the following keyword parameter: 


I0Al1=symbol 
where symbol (label) is the address of the I/O area. 
m Secondary Input/Output Area 


A secondary I/O area for standby processing may be specified by the following 
keyword parameter: 


IOA2=symbol 


where symbol (label) is the address of the secondary I/O area. 


(, 


m Current Record Pointer 


When a general register is used to reference current data, the following keyword 
parameter is specified: 


IORG=(r), 


where (r) may be general registers 2 through 12. The register must be specified 
if two output I/O areas are used and records are not to be processed in a work 
area. 


Logical IOCS places in the specified register the address of the next available 
output I/O area. 


a Printer Advance 


A standard form advance of one, two, or three lines is specified by the following 
parameter: 


PRAD=n 


where n equals 1, 2, or 8 to indicate single, double, or triple spacing respectively. 
—> The form advance takes place after the line is printed. If n equals 0, no form 
advance takes place. 


—> If the keyword parameter is not specified, a value of 1 is assumed. A delayed 
CNTRL macro instruction to space or skip after printing overrides this keyword 
parameter for one print line only. The keyword parameter should not be specified ad 
if CTLCHR=YES is used with the file. 
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a Printer Overflow 


This keyword parameter specifies the operation to be performed when a carriage 
overflow condition occurs. The carriage tape channel 9 (10019) is used to indicate 
the overflow. If the keyword parameter is not specified, printer spacing is controlled 
by the printer advance keyword parameter or the CNTRL macro instruction specifying 
spacing or skipping. 


There are two options available for handling a carriage overflow condition. 
—- PRTOV=YES 

This option provides an automatic skip to home paper in the paper tape loop. 
— PRTOV=symbol 


When this option is specified and overflow occurs, logical IOCS transfers control 
to the symbolic label of the address of the user’s overflow routine. 


The printer carriage is not automatically restored to the home paper channel. (The 
form overflow punch is not recognized during a printer skip operation.) To restore 
the printer carriage to home paper, a CNTRL macro instruction should be issued. 
The user must have specified the keyword parameter CNTRL=YES when the file was 
defined before the CNTRL macro instruction can be issued. 


The overflow routine may also print total lines, skip to home paper, and print 
overflow page headings. The routine should return control to logical IOCS at 
: the address stored in general register 14. Note that if imperative macro instruc- 
all tions are issued during the user PRTOV routine, register 14 must first be stored 
and reloaded; see 1.4. 
w Record Format 


Refer to Figure 2—26. One of the three following options describing the record 
format should be specified: 


—RCFM=FIXUNB 


Fixed-length records for print files are assumed by logical IOCS when this keyword 
parameter is omitted. 


—-RCFM=UNDEF 
This form is used for undefined records. 


—RCFM=VARUNB 


This form is used for variable-length, unblocked records. 
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ws Record Size 

















For print files with undefined format, the following keyword parameter is specified: 
RCSZ=(1) 
where (r) indicates the number (2—12) of the general register that holds the size of 
the output record. The record size must be entered into the general register before 
the PUT macro instruction is issued. 
m Work Area Processing 
If a work area is required in which to process output records rather than in the I/O 
area, the following parameter is specified. 
WORK=YES 
The address of the current work area must be specified with each PUT macro 
instruction. 
LABEL 6 OPERATION & OPERAND 
1 10 16 
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SPECIFICATION 


YES 


n=maximum block size 


CODE symbolic label 


CTLCHR YES 


ERROR symbolic label 


1OA1 symbolic label 
10A2 symbolic label 


lORG (r) = general register 


n=0,1,2,3 


YES 

symbolic label 
FIXUNB 
UNDEF 


VARUNB 


(rt) = general register 


LEGEND: 
R = Required 
X = Optional 


Y = One option required 





FILE 
OUTPUT 
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REMARKS 


Mismatched characters allowed 


The maximum block size 
Specify if CNTRL macro instruction 
is issued to file 


Address of user's Load Code Table 
(64-byte table) 


Indicates a control character is a 
part of each record 


Address of user’s unrecoverable 
error routine 


Address of output area 

Address of alternate output area 
General register (2—12) that contains 
the address of the current record 


each time a PUT is issued 


Standard form advance of zero, one, 
two, or three lines 


Automatic skip to home paper 

Address of user’s overflow routine 

For fixed-length records 

For undefined records 

For variable-length records 

General register (2—12) that contains 
the length of each record for undefined 


records 


Process records in work area 


Table 3~5. Summary of Keyword Parameters for the DTFPR Macro Instruction 
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LOAD SEQUENCE/ 
CHARACTER LOAD SEQUENCE/CHARACTER 


& (ampersand) 


Zz 
K 
J 
Q 
x 
V 
Ww 
Y 
P 
G 
B 
u 
M 
c 
D 
L 
F 
H 
s 
R 
) 
A 
N 


I 
T 


ray 


Oo aon DO oO FF WO ND 


(asterisk) 

(virgule) 

(plus) 

(dollar sign) 

(L paren.) 

(R paren.) 

(equal) 

(apostrophe) 

> (greater than) 

50. < (less than) 
51. ; (semicolon) 
52. : (colon) 
53. ¢ (cents sign) or[ (left bracket) 
54. | (absolute) 
55. -— (logical not) 
56. ——(underline) 
57. '* (quote) 


58. |! (excl. point) or | (right bracket) 


. (period) 59. 7? (question mark) 


, (comma) 60. \ (reverse virgule) 


. — (minus) 61. % (percent sign) 


0 (zero) 62. # (number sign) 





63. @ (at sign) 


64. NP Nonprinting code (this code will be 
used to produce spaces on the paper) 


Table 3—6, Ordering of Characters for the Load Code Sequence 


46 


Sa 
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No CHARACTER BINARY CHARACTER BINARY CHARACTER BINARY HEX 

& 01010000 11010110 01001110 4E 
z 11101001 E9 11000001 (44) §$ 01011011 5B 
K 11010010 D2 11010101 (45) ( 01001101 4D 
(4) J 11010001 Dl 11001001 cg (46) ) 01011101 5D 
(5) Q 11011000 08 11100011 (47) = 01111110 7E 
(6) x 11100111 E7 11000101 (48) ' 01111101 70 
(7) Vv 11100101 E5 01001011 (49) > 01101110 6E 
(8) Ww 11100110 E6 01101011 (50) << 01001100 4c 
(9) ¥ 11101000 E8 01100000 (51) 3 01011110 SE 
(10) P 11010111 11110000 (52). 75 01111010 7A 
(11) G 11000111 11110001 (53) ¢ orl 01001010 4A 
(12) B 11000010 2 11110010 (54) | 01001111 4F 
(13) U 11100100 3 11110011 (55) — 01011111 5F 
(14) 3M 11010100 4 11110100 (56) —— 01101101 6D 
(15) oC 11000011 5 11110101 (57) " 01111111 7F 
(16) D 11000100 6 11110110 (58) =! or | 01011010 5A 
(17) L 11010011 7 11110111 (59) 7? 01101111 6F 

(18) F 11000110 8 11111000 01101010 

(19) oH 11001000 9 11111001 01101100 
(20) S$ 11100010 (41) * 01011100 (62) # 01111011 7B 

(21) oR 11011001 / 01100001 01111100 

01000000 

NOTE: Character positions 53 and 58 may be optional bracket symbols if the system is 
provided with an ASCII modified print drum. 
ey Table 3—7. Standard Printer Code Conversion Table 


3.2.5. Optical Document Reader | 


The declarative macro instruction, DTFOR, is required when the processing of optically 
read files is desired. It serves the UNIVAC 2703 Optical Document Reader (ODR). 
Following is an alphabetic listing of the required and optional keyword parameters 
which may appear in the operand of the DTFOR macro instruction. 


A description of each keyword parameter follows the listing. A listing of the 
keyword parameters is given in Table 3—9 following the descriptions: 
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6B OPERATION 6 OPERAND 
filename BKSZ=n 
EOF A=symbol 
EOFB=n 
EOFC=symbol 
300 
FEED= 
ete 
1I0A1=symbol 
LGTH= n 


CARDB 
CARDT 
MARKB 
MARKT 
MODE=( OCR 
OCRCARDB 
OCRCARDT 
OCRMARKB 
OCRMARKT 


FIXUNB 
UNDEF 


_ f2 
STKR= oF 


[CNTRL=YES] 
{ERROR=symbol] 
[10A 2=symbol] ae 
[1ORG=(r)] 
[OPTION=YES] 
{MD10=YES] 
[RCSZ=(r)] 

01 

23 

45 

67 
[STSL=symbol] 
[WORK=YES] 


RCFM= { 


ROWS= 





NOTE: Assembler rules concerning commas and continuation of parameters in the 
operand field apply when writing this macro instruction; see 1.2. 


® Block Size 


This keyword parameter specifies the length of the I/O area and has the 
following format: 


BKSZ=n 


where n is the size of the block in bytes. If the records in a file have an 
undefined format, then n specifies the size of the largest record. 


If dual reading from the optical character recognition (OCR) and the mark 
or card read stations is to be performed, the BKSZ must include both fields. 
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® Control Entry 


If a CNTRL macro instruction is to be issued by a problem program, the 
following keyword parameter must be specified when the file is defined: 


CNTRL=YES 


Use of this keyword parameter indicates that a CNTRL macro instruction is 
to be issued for the following functions: 


— Selection of output stacker (per document) 

— Rejection of document 

Whenever the CNTRL keyword parameter is specified, the STSL keyword para. 
meter must also be specified. Refer to the STSL keyword parameter for 
further details. 


= End-of-File Address 


The address to which control is transferred when the end-of-data sentinel 
is sensed must be supplied by the following keyword parameter: 


EOFA=symbol 


where symbol (label) is the address of the routine which handles end-of-data 
processing. 


= End-of-File Sentinel Size 


This keyword parameter is required to specify the number of bytes contained 
in the end-of-file sentinel and has the following format: 


EOFB=n 
where n must be <BKSZ. 
® End-of-File Sentinel Address 


This keyword parameter is required to specify the address of the sentinel 
which will be used for comparison against each document image to determine 
when the end of file has been reached. This keyword parameter has the 
following format: 


EOFC=symbol 


The end-of-file sentinel characters must represent the first group of 
characters read on a document and, therefore, must be positioned closest 
to the right, or leading, edge of the document. 


There should be one end-of-file sentinel document present for each file 
processed, plus an additional blank or insignificant document to run 

out the reader properly. These documents are never passed to the user as 
a document image. 
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® Major File Error 


When a fatal hardware or detectable logical error occurs on a file, control 
will be transferred to a user’s error routine if the following keyword 
parameter is specified: 


ERROR=symbol 


where symbol (label) is the address of the error handling routine. When the 
logical IOCS transfers control to the routine, registers 1 through 12 are 
restored. Register 0 contains information concerning the reasons for the 
error as follows: 


— Bytes 0 and 1 reflect the first and second hardware sense bytes if 
the error is a hardware error; otherwise, they will be binary zeros. 


— Byte 2 contains a one-character EBCDIC value indicating in what section 
of processing the error occurred, where 4 = transients (OPEN or CLOSE) 
and 1 = processing. 


— Byte 3 contains a one-character EBCDIC value indicating the reason for 
the error (see Appendix E). 


Transients will also cause an informational typeout, inserting bytes 2 and 

r 3 as xx in the standard Data Management message format (DMxx). If this 
keyword parameter is not specified, abort procedures are executed when a 
major file error occurs. 


Further access of the file is not permitted after a major file error has 
occurred, 


® Document Feed Rate 


The UNIVAC 2703 Optical Document Reader is available with two document pro- 
cessing rates. The 300 document per minute (dpm) rate is standard; the 600 

dpm rate is an optional feature. The user must specify the rate at which he 

would tike to have his documents processed. Logical IOCS will attempt to 
maintain that specified rate. However, since documents are processed upon 

user request in a possible multiprogramming environment, the maximum docu- 
ment rate may not be achieved. The user can select the document rate desired 

by the following keyword parameter options: 


— FEED=300 


When this keyword option is selected, the logical IOCS specifies to the 
hardware a document rate of 300 dpm. 


— FEED=600 
When this keyword option is selected, the logical IOCS assumes the 600 docu- 
ment per minute feature installed and specifies to the hardware a document 


rate of 600 dpm. 


When this keyword parameter is not specified, a FEED rate of 300 dpm is assumed. 
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@ Input/Output Area 


Nee” 
Each input or output file must have an area reserved for its individual use. 
The area must be defined by the keyword parameter: 
I0Ai=symbol 
where symbol (label) is the address of the I/O area. 
Since all documents are read backward, that is, from right to left, the logical 
IOCS begins reading the data into IOA1+BKSZ—1. IOA1 is filled from back to 
front, so that after a document has been read in, it may be processed in the 
normal left to right manner. 
If mark sense or punch card fields are read in image mode, the I/O areas must 
be large enough to hold two bytes for each column of mark sense or punch card 
data read. 
If IOA2 is specified, the same reading conventions are applicable. 
= Secondary Input/Output Area 
A secondary I/O area for standby processing may be specified by the following 
keyword parameter: 
IO A2=symbol 
— 


where symbol (label) is the address of the secondary I/O area. 
Refer to keyword IOA1 for conventions regarding I/O areas. 


If IOA2 is specified, then either IORG or WORK must be specified. Refer to 
these keywords for details. 


® Current Record Pointer 


When a general register is used to reference current data, the following 
keyword parameter is specified: 


IORG=(r) 


where (r) may be general registers 2 through 12. The two cases in which IORG 
must be specified are: 


1. when two I/O areas are used and records are not processed in a work area; 
and 


2. when the record format is undefined. 


In each case, logical IOCS places the address of the next available record 
in the specified register. 
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= Document Length (LGTH) 


This keyword parameter is used to specify the physical length of the docu- 
ments to be processed. 


The format of the LGTH keyword parameter is: 
LGTH=n 
where n is a value from the following chart: 


VALUE OF n DOCUMENT LENGTH 





3.00 — 3.30 inches 
3.31 — 4.00 inches 
4.01 — 5.90 inches 
5.91 — 8.75 inches 


oOo wo 


The ODR hardware requires that the document length be between 3.00 and 8.75 
inches. 


When the LGTH keyword parameter is omitted, the IOCS assumes that a specifi- 
cation of 6 is valid. 


® Modulo 10 Check Digit Verification 


To verify numeric data read by the OCR camera with this feature installed, 
the following keyword parameter may be specified: 


MD10=YES 


In order to perform this feature, the data must have been printed with a 
check digit as the leftmost or rightmost digit in the OCR reading line. 


In addition, the OCR code line must also be enclosed within two long vertical 
marks (lvm). Absence of either or both will cause the document to be rejected 
(see Table 3—10). 


® Data Format Mode Selection 


Since the ODR will process OCR, mark sense, and punch card data fields, and 
the mark sense and punch card fields may be read in either translate or image 
mode, the following keyword parameter and its options are made available: 


MODE=CARDB 


This keyword parameter option is selected when only punch card information is 
to be read in image mode. Two bytes of data are read into memory for each 
column read on the document. The lower image of a column is transferred first 
(see Table 3—8). 


MODE=CARDT 
This keyword parameter option is selected when only punch card information is 


to be read in translate mode. Either ASCII or EBCDIC hardware translation 
will be performed, depending on hardware options installed. 
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Byte 2 P 0 1 2 3. 4 5 6 7 Y 


all x 0 0 | 
Rows 12 
11 
0 
1 
2 
3 


uv 
o 
_ 
NO 
Ww 
p~y 
ol 
oO 


Byte 1 


NOTE: When selected, the mark/card reading will transfer two data bytes for each 
column sensed, The lower image of the last column is the first byte transferred. 


Table 3—8. Image Mode Data Flow 


MODE=MARKB 


This keyword parameter option is selected when only mark sense informatiagn is 
to be read in image mode. Two bytes of data will be read for each marked 
column sensed on the document. The lower image of a column will be trans- 


ferred first. 
MODE=MARKT 


This keyword parameter option is selected when only mark sense information is 
to be read in translate mode. Either ASCII or EBCDIC hardware translation will 
be made, depending on hardware options installed. 


~ 
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MODE=OCR 


This keyword parameter option is selected when only the OCR data field is to 
be read from the documents. Data formats must be either USASCSOCR or 
UNIVAC H—14 fonts with EBCDIC or ASCII hardware translations, depending 
on the hardware options installed. 


MODE=OCRCARDB 


This keyword parameter option is selected when both OCR and punch card data 
is to be read and the punch card field is to be read in image mode. 


MODE=OCRCARDT 


This keyword parameter option is selected when both OCR and punch card data 
is to be read and the punch card field is to be read in translate mode. 


MODE=OCRMARKB 


This keyword parameter option is selected when both OCR and mark sense data 
is to be read and the mark sense field is to be read in image mode. 


MODE=OCRMARKT 


This keyword parameter option is selected when both OCR and mark sense data 
is to be read and the mark sense field is to be read in translate mode. 


When this keyword is not specified, OCR mode is assumed. 
= Optional Input File 


The keyword parameter that allows the user to specify an optional input file 
is: 


OPTION=YES 


When this keyword parameter is specified and the file has not been allocated 
to a device by the Job Control program, the OPEN transient routine ensures 
that logical IOCS transfers control to the address of the user’s end-of- 

file routine (EOFA) following the execution of the first GET macro instruc- 
tion. This procedure maintains continuity in the user’s program. The user 

is required to CLOSE the optional file. 


When this keyword parameter is not specified and the file has not been allo- 
cated by the Job Control program, it is impossible to obtain records from the 
file. Logical IOCS transfers control to the address of the user’s error routine 
(ERROR), If a user error routine is not supplied, the job step is aborted. 

® Record Format 


One of the following options describing the record format should be specified: 


RCFM=FIXUNB 
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This form specifies fixed-length record format. 


RCFM=UNDEF 
This form is used for undefined record format. If the record format is unde- 
fined, either IORG or WORK must be specified. Refer to these keywords 
for details. If this keyword is not specified, fixed-length format is speci- 
fied. 
= Record Size 
For files with undefined record format, the following keyword parameter is 
specified: 
RCSZ=(r) 
where (r) indicates the number (2—12) of a general register. Logical IOCS 
determines the size of the current record and places it in the specified 
register. 
@ Mark Read Row Selection 
This keyword parameter is specified when two-row sorting is desired. There 
are four forms of the keyword parameter which can be used. 
— ROWS=01 
a 


This form implies rows 0—1. 
— ROWS=23 

This form implies rows 2—3. 
— ROWS=45 

This form implies rows 4—5. 
— ROWS=67 

This form implies rows 6—7. 
If this parameter is specified, STKR=2 must also be specified. The logical 
IOCS will direct all documents to stacker 2 except those documents with a 
mark present in the selected rows of the rightmost column of the mark/read 
field. 
Whenever this key word parameter is specified, it is assumed stacker 2 is 


selected. Logical IOCS cannot support this feature unless the optional 
hardware is installed. 
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® Stacker Mode Selection 


Output stacker selection can be preset by specifying one of the following 
keyword parameters and its options: 


STKR=2 
STKR=3 


All documents read without error will be prerouted to the output stacker 
specified. However, when mark read row selection has been specified, the 
output stacker selected is dictated by the data read. 


All documents read in error are routed to the reject stacker 1 and any 
erroneous document images present will not be made available to the 
user, 


® Program Controlled Stacker Selection 


If the user wishes to select stackers on an individual document basis, he 
must specify the STSL keyword in addition to the CNTRL keyword. The STSL 
keyword parameter has the following format: 


STSL=symbol 


where symbol is the address of the first instruction of the user’s stacker 
select subroutine. 


The user’s STSL routine is incorporated into the GET processing. After the 
document is read in, program control is passed to the STSL routine. Upon 
entering the STSL routine, registers 2-12 appear as they did when the GET 
was issued, except that the IORG and RCSZ register, if specified, have 

been set. The user must not process the document at this time other than to 
determine the output stacker desired and to issue the appropriate CNTRL 
macro (see Table 3—7). The STSL routine must not alter registers 0, 1, 13, 

14, 15 nor the register save area. Alterations to registers 2—12 will be 
preserved. 


After the CNTRL macro is issued, program control must be returned to 
GET by executing the following branch instruction: 


B 4(0,15) 
@ Work Area Processing 


The logical IOCS makes the current record available to the user in a work 
area if the following keyword parameter is specified: 


WORK=YES 


The address of the current work area must be specified with each GET 
macro instruction. 
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LABEL tf OPERATION 8 OPERAND % COMME 
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FEED= 600, 
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1. The label DOCIN names this file. All references to this file (e.g. GET, 
CNTRL) must specify this filename. This filename must also appear in 
the Job Control Stream (//LFD). The block size is 60 bytes. Each I/O 
area is 60 bytes long. 

2. The data is to be read in mark sense — image mode (see Table 3-8). Since 
each column is read into 2 bytes and the block size is 60, there can be 
only 30 columns. 

3. When the right or leading column of the last document is read in, it will 
produce a bit configuration exactly like the 2 bytes stored at EOFCHAR. 
When Logical IOCS detects this configuration, it will transfer control 
to the routine at DONE. 

4,5,6. Two I/O areas are used to allow input-processing overlap. The documents 
are then moved to a work area the address of which is specified for each 
GET. 

hs The documents are between 3 and 3.2 inches long. 

8. The documents are to be read in fast feed mode. 

9,10. With the following exceptions, all documents are directed to stacker 2. 
a. All documents read in error are directed to the reject stacker. 

b. All documents with a mark in row 4 or 5 of the right or leading 
column will be directed to stacker 3. 
11. If Logical IOCS detects any logic errors, or if an unrecoverable hardware 


error occurs, control is transferred to the routine at CANJOB. 
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KEYWORD SPECIFICATION 


n=maximum block size 
YES 

symbolic label 

n 

symbolic label 


symbolic label 


300 


600 


symbolic label 
symbolic label 


(r)=general register 
(2—12) 


YES 


CARDB 
CARDT 
MARKB 
MARKT 


OCR 
OCRCARDB 


OCRCARDT 
OCRMARKB 


OCRMARKT 


OPTION YES 
RCFM FIXUNB 
UNDEF 
RCSZ (r)=general register 
(2—12) 
LEGEND: 
R = Required 
X = Optional 


Y = One option required 
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The maximum block size, in bytes 


ACNTRL macro will be issued for the 
file 


Identifies end of file routine 
Specifies length of end of file 
sentinel 

Address of end of file sentinel 


Address of user’s unrecoverable error 
routine 


Specifies document feed rate of 300 
dpm 
Specifies document feed rate of 600 
dpm 


Address of input area 
Address of alternate input area 


Required when two 1/O areas are used 
without a work area or when processing 
undefined records without a work area 


Specifies the physical size of the 
documents 


To verify correctness of numeric a 
data read by OCR ” 


Specifies punched card data is to be 
read in image mode 

Specifies punched card data is to be 
read in translate mode 

Specifies mark sense data is to be 

read in image mode 

Specifies mark sense data is to be 

read in translate mode 

Specifies OCR data is to be read 
Specifies OCR with punched card data 
read in image mode 

Specifies OCR with punched card data 
read in translate mode 

Specifies OCR with mark sense data 
read in image mode 

Specifies OCR with mark sense data 
read in translate mode 


Specifies an optional file 


For fixed-length records 
For undefined records 


For undefined records, register 
contains record size 


peed 


Table 3—9,. Summary of Keyword Parameters for the DTFOR Macro Instruction (Part 1 of 2) 
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a KEYWORD SPECIFICATION 


2 
3 


symbolic label 


LEGEND: 
R = Required 
X = Optional 


Y = One option required 
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For mark read row selection — 
rows O and 1 
For mark read row selection — 
rows 2 and 3 
For mark read row selection — 
rows 4 and 5 
For mark read row selection — 
rows 6 and 7 


Specifies output stacker 2 
Specifies output stacker 3 


Address of the first instruction 
of the user stacker select sub- 
routine for selecting stackers on 
an individual document basis 


For processing records in a work 
area 


Table 3—9. Summary of Keyword Parameters for the DTFOR Macro Instruction (Part 2 of 2) 
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Document Format 


The format for documents used with the ODR is shown in Figure 3—1. 


8.75°° MAXIMUM 





(NOTE 3) 













0.2"" MAXIMUM 








—| 0.5" 


NOTES: 


Poormooooomo 


1. 














/ AS ie ee OS a me EO a he OT gt gn ea eee ale a age et eee tl wy i Pe 


es erage a -~-—_—___—_—————_ 3.0" MINIMUM 


| (NOTE 3) 









DIRECTION 
OF 
FEEDING 





= aaa eres een J rv) sss case | oss ¢ see | mn | me | Os |S) 


(NOTE 4) 0.125" (NOTE 3) 


3/8-inch minimum width; 1/2-inch width recommended. 

No part of the OCR clear band may be in this one-inch wide area. 
Edge tear zones. OCR clear band not recommended in this area. 
Timing marks. 


The clear band is a horizontal band, a minimum of .38 inch in width, within 
which is centered the character line. The clear band may be located anywhere 
on the document except as noted. It is recommended that the clear band extend 
to the right edge (leading edge) of the document and have a 1/2-inch width. 


The printing area is a horizontal band .20 inch in width in the center of the 
clear band in which all characters to be recognized must be printed. The print- 
ing area must terminate at least .38 inch from both right and left edges of the 
document. 


The horizontal character spacing (distance between adjacent character centerlines) 
must not be less than .09 inch and the average must not be less than .10 inch. 


All columns to be mark read are defined by the presence of pre-printed black timing 
or ‘‘tic’’ marks, located on the bottom of the document and immediately adjacent to 
the leading edge of the columns they identify. A maximum of twelve locations per 
column is permitted. 


Whenever both the OCR reading and the mark/card reading are selected, it is necessary 
to define an acceptable document format such that ambiguous data transfer cannot 
occur. The OCR code line on a punched card must not extend more than 5.50 inches 
from leading (right) edge. The OCR code line on a mark read document must not 
extend more than 5.50 inches to the left of the rightmost timing mark. 


Figure 3—1. Document Format 
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OCR CLEAR 


BAND 


(NOTE 5) 


| (NOTE 1) 


2.75°’ MINIMUM 
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3.2.5.2. Typical Application 















































































































A typical application of the ODR’s capabilities is shown in Figure 3—2. 
THE SOLAR LIGHT AND COKE COMPANY 7 
9420370429166919393 
are ACCOUNT NUMBER 
f 0 04 4 
x i 
| | Wid 
x x x x 
22 2:2 2 
x xX X ' x x 
333.33 
xX xX xX x xX 
44414 4 
xy SX ‘xk xX 
55 fs 5 
x xX 1X x 
6 6 6:6 6 
x xX xX ; x xX 
17 77:17 7 
x xX Xx } x x 
888.8 8 
x xX X ; x xX 
999199 RETURN THIS STUB WITH YOUR PAYMENT 
UNIVAC 
9400 METER 
SERIES READER'S DATA COLLECTION PHASE 
eS : COMPUTER FORM 
nee” 
CUSTOMER BILLING PHASE 
UNIVAC UNIVAC 
CUSTOMER 9400 wee 
ACCOUNTS CUSTOMER 
RECEI ae E : Bi ni its ileal? 
BAe CUSTOMER 
UNIVAC UNIVAC 
TYPE 9400 
2703 SERIES 
OOR COMPUTER 
MASTER 
BILL 
FILE 


Figure 3—2. A Typical Public Utility Application 
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3.2.5.3. Font/Code Relationship 














4 
Table 3—10 lists the font/code relationship of the United States of America Standard 
Character Set for Optical Character Recognition (USASCSOCR) or the UNIVAC 
H—14 and the Extended Binary Coded Decimal Interchange Code (EBCDIC) or the 
American National Standard Code for Information Interchange (ASCII). Either font 
and code may be selected for use with the ODR. 
USASCSOCR H—14 ESCDIC 
CHARACTER | CHARACTER ENCODING 
0 10) FO 30 , 
1 1 Fi 
2 2 F2 
3 3 
4 4 
5 5 
6 6 
7 7 
8 8 
9 9 
J N 
y F 
d \ 
|* |* 
Multiple ** Multiple** 
*The long vertical mark (Ivm) is used to define a field within a scan line. The !vm’s are 
printed by the computer when the forms are prepared. When the Ivm is read by the ODR, the 
selected encoding is sent to the computer. Nee 


**This word is not printed by the computer or read by the ODR. The respective code, depending 
on the encoding selected, is sent to the computer when the ODR cannot recognize a character. 


Table 3—10. Font/Code Relationship 


3.2.5.4. Modulo 10 Check Digit Verification 


This feature verifies the correctness of the numeric optical reading. If the feature 
is installed and the MD10=YES keyword parameter is included in the DTFOR 
macro instruction, the internal hardware of the ODR performs a weighted addi- 
tion of the digits read from the documents. To perform this test, the data is 
printed with a check digit. The check digit is program-calculated and is printed 
as the rightmost digit in the optical character reading line. The check digit can 
be calculated as follows: : 


1. Multiply the units position and every alternate position of the basic number 
by two. 


2. Cross add the digits in the products and the digits in the basic number not 
multiplied by two. 


3.  Subtraet the cross-footed total from the next higher number ending in zero. 


4. The difference is the check digit. 
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Example: 

Basic account number to be printed: q 3 0 7 4 
Units and every alternate position: q 0 4 
Multiply by two: ; 2 2 2 
Product: 14 0 8 
Digits not multiplied by two: 3 7 
Cross-add: 1+ 44+3+0+7+ 88 


Next higher number ending in zero: 

Subtract crossfooted total: _ 

Check digit: 

Self-checking number: 7 3 0 7 4 
When the basic account number and the check digit are read by the ODR, a 


similar calculation is made in reverse to assure that the weighted sum of the 
digits is a multiple of 10. In the example, the correct sum is 30. 


23 


30 


23 


If the sum is not a multiple of 10, a digit was read incorrectly. An error indi- 


cator is set and the document goes to the reject stacker (stacker number 1). 


Paper Tape 


PAGE: 


The declarative macro instruction, DTFPT, is required for input and output paper tape files. 
Following is a listing in alphabetic order of the required and optional keyword parameters 


which may appear in the operand of the DTFPT macro instruction. 


A description of each keyword parameter follows the listing. A summary of the keyword 


parameters is given in Table 3—11 following the descriptions. 
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} LABEL % OPERATION 6B OPERAND 


BKSZ=n a 
EOFA=symbol 

I0A1=symbol 

[EOR=expression] 


IGNORE 
ERRO=< SKIP 

symbol 
[ERROR=symbol] 
[FSCAN=symbol] 
[FTRANS=symbol} 
[104 2=symbol] 
[1ORG=(r)] 
[LSCAN=symbol] 
[LTRANS=symbol] 


[Mope-{eny Ty] 


[OBKS=n] 
[OPTION=YES] 

_ {FIXUNB 
[RORM TO NDEF ] 
[RCSZ=(r)] 


[SCAN=symbol] 
[TRANS=symbol] 


INPUT 
[TYPE JOurruay| ae 


[WORK=YES] 


filename 





NOTE: Assembler rules concerning commas and continuation of parameters in the 
operand field apply when writing this macro instruction; see 1.2. 


= Block Size 


This keyword parameter is required for both input and output files. The format is: 
BKSZen 


where n (decimal) is the size of the block in bytes. For undefined record format files, 

the size must be that of the largest record and must include the end-of-record character, 
on both input and output. For shifted output files of undefined length records, the size 
must include any figure or letter shift characters which might be added into the record. 


The maximum size of a block on paper tape is 4095 bytes. 
= End of an Input File 


The address to which control is transferred when the end-of-tape condition is sensed must 
be specified by the following keyword parameter: 


EOFA=symbol | nee! 


where symbol (label) is the address of the user’s end-of-tape routine. This is required 
for input files. 
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The end-of-tape routine may close the file, or if desired, cause another tape to be 

mounted and return to logical IOCS via register 14. In the latter case, IOCS reads in 

Nee! the next record and delivers it to the GET macro call which encountered the end-of-tape 
condition. If any other logical IOCS imperative macros are called, register 14 and the 
save area must be saved and restored. 


@ End-of-Record Character 


The value of the user-defined end-of-record character must be specified by the following 
key word parameter: 


EOR=expression 


This parameter must be used for output files with undefined record format only. Any 
self-defining term, or a symbol which has been equated to the desired value, may be used 
here. Logical IOCS appends this character to the undefined record before writing it. 


™ Unique File Errors 


This parameter applies only to input files. A unique error is an unrecoverable parity 
error. If a unique error occurs when reading a block of data, the user has the following 
options: he may process the block as if no error had occurred, bypass the block, enter 
a special routine for individually processing error blocks, or terminate the job. The 
absence of this parameter specification causes the logical IOCS to assume that a job 
should be terminated if a unique error occurs. The other options are specified as 
follows: 


— ERRO=IGNORE 


og 
This option permits the images in the I/O area to be available to the user as though 
no error had occurred. If the mode is not binary, the most significant bit of any 
character with a parity error is set toa 1. 
— ERRO=SKIP 
This option causes the block in error to be bypassed and the next error-free block 
to be accessed. 
— ERRO=symbol 
For this option, symbol (label) is the address of a user’s error routine to process 
any errors. When logical IOCS transfers control to the user’s error routine, register 
14 contains the normal return address. Registers 2 through 12 are restored. Register 1 
contains the address of the block in question for both input and output files. In 
addition, the following rules are observed: 
1. Do not destroy the present register save area (pointed to by register 13). 
2. Return with register 13 containing the save area address. 
3. Donot issue a GET or PUT instruction on the file. 
4. Access the record by means of register 1. 
ee 


5. Use another save area for any other IOCS file. 


6. Return by transferring control to the address contained in register 14. 
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= Major File Error 


When a fatal hardware or detectable logical error occurs on a file, the user may have 
control transferred to a special error handling routine by specifying the following 
keyword parameter: 


ERROR=symbol 


where symbol (label) is the address of the error handling routine. When logical IOCS 
transfers control to the routine, registers 1 through 12 are restored. If control is 

passed to the error address from a processing macro instruction (such as GET and PUT), 
the address of the instruction following the macro call can be found in register 14. 
Register 14 is restored to the value in the register preceding the transient call 

(OPEN and CLOSE). Register 0 contains the following information concerning the 
reasons for the error: 


— Bytes 0 and 1 reflect the first and second hardware sense bytes if the error is a 
hardware error; otherwise, these bytes contain binary zeros. 


— Byte 2 contains a one-character EBCDIC value indicating in what section of 
processing the error occurred, where 4 = transients and 1 = processing. 


— Byte 3 contains a one-character EBC DIC value indicating the reason for the error 
(see Appendix E). 


Transient routines also cause an informational typeout, inserting bytes 2 and 3 as 

xx in the standard Data Management message format (DMxx). If this keyword parameter 
is not specified, abort procedures are executed when a major file error occurs, but 

the console typeout still appears. 


Further access of the file is not permitted after a major file error has occurred. 


One exception to the above holds — an end-of-record character error for an input file 
with undefined record format. If an incoming record fills the input area before an 
end-of-record character is detected (by the hardware), an end-of-record character 

error is assumed. In this case, logical IOCS will allow the user program to return 

from the error routine via register 14. The same precautions listed under ERRO=symbol 
must be followed. Note, however, that register 1 does not point to the record and the 
record is not available to the user program. If the error routine returns to logical 

IOCS via register 14, the next record is read. 


NOTE: To avoid an EOR error, the input area (as described by BKSZ) must be 
at least one byte longer than longest record anticipated. 


= Shifted Code for Output Files — Figure Scan 


To handle shifting codes for output files, the keyword parameter LSCAN and the 
following keyword must be specified: 


FSCAN#=symbol 
where symbol (label) is the address of a scan table in the problem program used to 
define characters to be treated as figures. The table is indexed by the characters in 


the output data. 


Entries corresponding to letters must contain the code for the letter shift. All other 
entries must contain a byte of zero. 
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® Shifted Code for Input Files — Figure Translation 


To handle shifting codes for input files, the keyword parameters SCAN and LTRANS and 
the following keyword parameter must be specified: 


FTRANS=symbol 


where symbol (label) is the address of a translation table in the problem program for 
those characters following a figure shift character. 


NOTE: When FTRANS and LTRANS are specified, the keyword TRANS must not be 
specified. 


= Input/Output Area 


Each input or output file must have an area reserved for its individual use. The area 
must be defined by the following keyword parameter: 


IO0A1=symbol 

where symbol (label) is the address of the I/O area. The length of the area is speci- 
fied by the keyword parameter BKSZ for all but files with shifted code and fixed- 
unblocked records. For the latter type of file, the keyword parameter OBKS specifies 
the length. 

® Secondary Input/Output Area 
A secondary I/O area for standby processing improves efficiency by overlapping I/O 
and record processing time. The format of the keyword parameter for a secondary I/O 
area is: 


I0A2=symbol 


where symbol (label) is the address of the secondary I/O area. It is subject to the 
same requirements as noted in IOA1. 


® Current Record Pointer 


When a general register is used as an index register to reference current data, the 
following keyword parameter should be specified: 


IORG=(r) 


where (r) is the number of the general register (2—12). If a work area is not required, 
this keyword parameter must be specified when there are two I/O areas. 


For input files, logical IOCS places the address of the next available record in the 
specified register. 


For output files, logical IOCS places in the specified register the address of the 
next available I/O output area. 
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® Shifted Code for Output Files — Letter Scan 





To handle shifting codes for output files, the keyword parameter FSCAN and the 
following keyword must be specified: 


LSCAN=symbol 
where symbol (label) is the address of a scan table in the problem program used to 
define characters to be treated as letters. The table is indexed by the characters in 
the output data. Entries corresponding to figures must contain the code for the figure 
shift; all other entries must contain a byte of zero. 


Shifted Code for Input Files — Letter Translation 


To handle shifting codes for input files, the keyword parameters SCAN and FTRANS and 
the following keyword must be specified: 


LTRANS=symbol 


where symbol (label) is the address of a translation table in the problem program 
for those characters following a letter shift character. 


NOTE: When FTRANS and LTRANS are specified, the keyword parameter 
TRANS must not be specified. 


Input/Output Mode 


This keyword parameter is used to specify the input/output mode of operation of the 
paper tape subsystem. There are two forms of specification of this keyword. 


— MODE=BINARY 


This form is used to suppress character recognition and bypass parity. All eight bits 
of data are read into the I/O area from the reader on input and eight bits of data 
from the I/O area are punched on output. The program connector must be wired to 
suppress parity for MODE=BINARY to be valid. 


— MODE=STD 


This form is used to allow character recognition and is the default if MODE is not 
specified. 


Over-Block Size 


The following keyword parameter specifies the size of the input/output area for fixed 
‘unblocked files with shifted codes: 


OBKS=n 


where n is a decimal number not exceeding 4095. If this parameter is not specified, 
then BKSZ is used. 


For input files, OBKS specifies the number of characters to be read in, before Se 
compression and translation, to produce the number of characters specified by BKSZ. 

If compression causes a reduction below BKSZ length, then more characters are read 

to fill the I/O area to OBKS and compression and translation continues. 
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For output files, OBKS specifies the maximum record size. If OBKS is large enough to 
Nee allow the insertion of all the shift characters required to build the output record, 

a single write operation results from a PUT macro. Otherwise, several output opera- 

tions may result from a single PUT call. 


= Optional Input File 
The keyword parameter to allow the user to specify an optional input file follows: 
OPTION=YES 


When this keyword parameter is specified and the file has not been allocated toa 
device by Job Control, the OPEN transient routine ensures that logical IOCS will 
transfer control] to the address of the user’s end-of-file routine (EOFA) follow- 
ing the execution of the first GET macro instruction. This procedure maintains 
continuity in the user’s program. The user is required to close the optional file. 


When this keyword parameter is not specified and the file has not been allocated by 
Job Control, it is impossible to obtain records from the file, if one exists. Logical 
10CS transfers control to the address of the user’s error routine (ERROR). If a 
user error routine is not supplied, the job step is aborted. 


® Record Format 
The record format of a file is specified by a keyword parameter. There are two options 


to indicate whether the records are fixed-length unblocked, or undefined. The options 
are coded as follows: 


— RCFM=FIXUNB Fixed-length, unblocked 
— RCFM=UNDEF Undefined 
Logical IOCS assumes a fixed-length, unblocked record format when this keyword 
parameter is not specified. 
= Record Size 
The number of bytes in a record is made available to logical IOCS by this keyword 
parameter. Logical IOCS assumes that the record size is equal to the block size for 
fixed-length, unblocked records. 
— RCSZ=(r) 
This form of the keyword parameter is required for output files with an undefined 
record format. The general register (2—12) specified by (r) contains the block 
length. The keyword parameter may also be used for input files. Logical IOCS 
places the block length into the general register specified by (r). 
= SCAN Table 
This keyword parameter is required for input files with shifted code, along with FTRANS 
and LTRANS. It can also be specified for files which may have certain characters to 
ae, be deleted before processing starts. The format is: 


SCAN=symbol 
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where symbol (label) is the address of a scan table in the problem program. The entries 
in this table are accessed by using the input data as index. 


There are three nonzero entries possible: 


X‘04’ — defines the figure shift character. All data following up to the next shift 
character is translated via FTRANS. 


X‘08’ — defines the letter shift character. All data following up to the next 
shift character is translated via LTRANS. 


X‘OC’ — _— defines a ‘delete’ character. The corresponding data character is deleted 
from the record, following characters moved one byte to the left. 


There must not be any 04 or 08 entries unless FTRANS and LTRANS are specified. 
All other entries in the SCAN table must be 00. 


@ Translate Table 


This keyword parameter defines a table to be used on the data via the translate (TR) 
instruction. The format is: 


TRANS=symbol 
where symbol (label) is the address of the translation table in the problem program. 


For an input file, translation is performed after any deletions that may be required. 
TRANS cannot be specified for an input file with shifted code. 


For an output file, translation is performed after any insertion of shift characters. 
The shift characters, however, are not translated. 


= Type of File 
The type of file is specified by this parameter: 
— TYPE=INPUT 


This keyword parameter specifies an input file (one that is to be read). This option is 
assumed if the parameter is not specified. 


— TYPE=OUTPUT 
This keyword parameter specifies an output file (one that is to be written). 
@ Work Area Processing 


If records in an input file are to be transferred from the input I/O area to a work area, 
the following keyword parameter must be specified: 


WORK=YES 


This keyword parameter must also be specified for output files when records are to be 
built in a work area. 


The user must specify the address of the current work area with each GET and PUT macro 
instruction. 


70 


UP-7629 
Rev. 2 











UNIVAC 9400 
DATA MANAGEMENT SYSTEM 





3 


SECTION: 









PAGE: 

















LABEL 8 jr ae OPERAND B COMM 

“PAP EIR, Pie, tN pes FLUC E, WITH, SHIFTED) CODES, - SAMPLE, | 

gil oa on it pS ze poh | Er eee © { ary ree rem eee 

APE TING 4 ae Bw S220. Pp te a Pt a 

tpiirit Fistacaase. peatirviy ir dag gato ay tr riirts 
| [eT RANIS =F 1 G/C,O.NV,, 


4 Hecate poe et 





iit 1 Pen gece EERECeR poirtiriito 








Piiud Hfuteamacas ition Oar ye ey REGO War WO a TC TO 





feueoemernes porter irtirgirtirpiids 





OB KS =|1 28, 


RC FMA MUNB, tit Pe Pa tp te 





SCAN#* [BRE A KITA 


rea Pc OO 








T VP Et INPUT), | pete he 11 cae a ea [cee ae ea 4 








WORK IVES, bere atari Peer Pe ti 
































PUT, FRE, | SAMPLE, Pt L 
it ot rato Ya Se | i 11 pitupiue ia ik | ) ae ora Me Weave LRM ee ne pine Coens Smee Oy 
BK S21 2te yy tet a 
EQ RA Xl 4S al pp br Pa Pa Pd 
ERROR USE RROR, 

Cre eee eee hae me men amie eects en 

| | 0,42, 10,u,7,2, 

 |iore 5), ei 

| |R,C, FM, |U,N,0,€,F), 

| |rics z= 4), 

| [7,R,AN,S = ,C,0,N,VjE,R,T,, 

| [tv € = )0,U,7,P ut P4. 

| 


SPECIFICATION INPUT | OUTPUT 





n = maximum block size R The maximum block size, in bytes 

symbolic label Identifies EOF routine 

expression xX Defines end-of-record character 
— required for UNDEF output 

IGNORE Treat error block in input file 
normally : 
Skip the block containing the 
error 

symbolic tabel Address of user routine to process 
unique errors 

symbolic label Xx Address of user’s unrecoverable 
error routine 


LEGEND: 
R = Required Y = One option required 
X = Optional + = Assumed parameter, if none specified 


Table 3—11. Summary of Keyword Parameters for the DTFPT Macro Instruction (Part 1 of 2) 
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FSCAN 


FTRANS 


10A1 


tOA2 


1ORG 


LSCAN 


LTRANS 


MODE 


OBKS 


OPTION 


RCFM 


LEGEND: 
R = Required 
X = Optional 
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SPECIFICATION 


symbolic tabel 


symbolic label 


symbolic label 


symbolic label! 


(r) = general register 


symbolic label 


symbolic label 


BINARY 


n = maximum I/O area size 


YES 


FIXUNBT 


UNDEF 


(r) = general register 


symbolic label 


symbolic label 
INPUTT 
OUTPUT 


YES 


Y = One option required 


t = Assumed parameter, if none specified 
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Address of figure scan table 


Address of figure translation 
table 


Address of input/output area 


Address of alternate input/output 
area 


Required if records are processed 
in the I/O area and there are two 
1/0 areas 


Address of letter scan table 


Address of letter translation 
table 


Suppress character recognition or 
parity generation 


Character recognition or parity 
generation effective 


Maximum 1/O area size for shifted 
code 


For specifying an optional file 


For fixed-length, unblocked 
records; assumed 


For undefined records 


For undefined output records; 
register contains record size 


Optional for input file; register 
contains record size 


Address of scan table for input 
files 


Address of translation table 
For input fites; assumed 
For output files 


Process records in work area 





Table 3—11. Summary of Keyword Parameters for the DTFPT Macro Instruction (Part 2 of 2) 
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IMPERATIVE MACRO INSTRUCTIONS 


The imperative macro instructions supplied for sequential accessing are OPEN, GET, 
PUT, RELSE, TRUNC, CNTRL, LBRET, FEOV, and CLOSE. Not all macro instructions 
are available for use on all devices that can be accessed sequentially. Some are specifi- 
cally input type macro instructions and cannot be used for an output device; the opposite 
is true, also. When a parameter applies only to specific devices, attention is called to 
this fact in the accompanying description. 


OPEN Macro Instruction 


Before a file can be accessed by logical IOCS, an OPEN macro instruction is issued. 
The transient routine called by the OPEN macro instruction performs certain validation 
checks and initiates file processing. 


A check is made to determine if all the necessary keyword parameters defining the file 
have been supplied. The device allocation performed by the Job Control program is 
determined. 


The actions performed by the OPEN transient routine depend on whether the file is an 
input or an output file. For input files, the first data record is not available to the user 
until a GET macro instruction is issued. For output files no data is written; however, 
the data area is made available for use. The ability to reopen a file is also provided. 


For magnetic tape and sequential disc files, the job stream is accessed to obtain the 
necessary label and volume information. Label validation is carried out. The keyword 
parameter FLBL of the DIFMT macro instruction determines the validation procedures 
for magnetic tape. Since standard labels are required on discs, the validation performed 
is not variable. User label processing for both tape and disc files is specified by the 
LBAD keyword parameter. 


The format of the OPEN macro instruction is: 





& OPERATION & 






OPERAND 





filename 
filename-1, filename-2,...,filename-n 


(1) 


{name] 


POSITIONAL PARAMETER 1 


filename — is the label(s) of the corresponding DTF (define the file) macro 
instruction(s) in the program. The filename may have a maximum of 
seven characters. 


(1) — indicates that register 1 has been preloaded with the address of the 
declarative macro instruction. 


Example: 














LABEL & OPERATION 6 OPERAND 


PNP.U TT, OUTPUT, LAS TENGE | a te 





1. Enters the transient routines necessary to prepare the DTF macro instructions 
whose labels are INPUT, OUTPUT, and LISTING. Checks that they are pre- 
pared to access these files with the next imperative macro instruction (GET, 
PUT, and so forth). 
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3.3.2. GET Macro Instruction 


This macro instruction causes the next logical record in an input file to become 
available to the user. The data is accessible either in the I/O area or in a user 


specified work area. The macro instruction is used for all record types. 


Users that specify only one I/O area and have neither blocked records nor variable- 
length tape records to be read backwards may directly access data relative to the 
name of the I/O area. All other users must specify a register (by means of the IORG 
keyword parameter) to be used by logical IOCS to give the starting address of the 
current record or must specify a work area in the declarative macro instruction. More 
than one work area may be employed, since the address of the area is specified to 
logical IOCS with each GET macro instruction. Each GET macro instruction may 
specify a different work area, if necessary. 


The format of the GET macro instruction is: 


LABEL 6 OPERATION & OPERAND 
filename workarea 
[name] ; 
(1) (0) 





POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTF (Define The File) macro instruc- 
tion in the program. 


(1) — indicates that register 1 has been preloaded with the address of the 
declarative macro instruction. 


POSITIONAL PARAMETER 2 


workarea — is the label of an area into which the current record is moved for 


processing. 

(0) — indicates that register 0 has been preloaded with the address of a 
work area, 

if blank — indicates the user has chosen processing either by means of a register 


(IORG keyword parameter) or by directly accessing the data relative to 
the name of the I/O area. 


NOTE: When the work area is specified, the keyword parameter WORK=YES must 
be present in the DTF statement. 


Example: 










LABEL & OPERATION 6 OPERAND 









LIHERE, |, . Te FPN PUT UNWORK, 2 oo bo pa bt ah 








bodes oy ee a ee a le ies Pee ae od, 


1. Places the next record of the file described in the DTF macro 
instruction, whose label is INPUT, into the area whose label 
is INWORK. The optional label HERE may be used to reference 
this point in the program. 





UP-7629 
Rev. 2 







3.3.3. 


UNIVAC 9400 
DATA MANAGEMENT SYSTEM 














SECTION: PAGE: 


PUT Macro Instruction 


This macro instruction causes an output record to be delivered to logical IOCS in 
either the output I/O area or a user specified work area. The record is then no longer 
available to the user. 


Depending on the record format (RCFM keyword parameter), logical IOCS groups the 
output records or delivers the records singly to the output peripheral device. A general 
register (2-12) must be supplied (by means of the IORG keyword parameter) when the 
records are blocked or when a standby area (IOA2) is specified and when no work area 
is used. This provides logical IOCS with a place to put the address of the current 
output area. Unblocked records processed in an I/O area can be referenced directly 

by means of the name given to that area (IOA1) by the user. 


The output I/O area(s) is not cleared after the current output data is sent to the device. 
Care should be exercised to clear the area before use or to supply complete records, 
including blanks, to logical IOCS to prevent unwanted information from appearing in the 
data. 


When records are processed in a work area, logical IOCS moves the record into the I/O 
area. This frees the work area for subsequent processing by the user. 


The format of the PUT macro instruction is: 


LABEL | 6 OPERATION 6 OPERAND 


filename workarea 
[name] 


(1) (0) 





POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTF (Define The File) macro instruc- 
tion in the program. 


(1) — indicates that register 1 has been preloaded with the address of the 
declarative macro instruction. 


POSITIONAL PARAMETER 2 


workarea — is the label of the work area from which the record may be obtained. 


(0) — indicates that register 0 has been preloaded with the address of the 
work area. 
if blank -— indicates the user has chosen processing either by means of a register 


(IORG keyword parameter) or by directly accessing the data relative 
to the name of the I/O area. 


NOTE: When the work area is specified, the keyword parameter WORK=YES must 
be present in the DTF statement. 
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Example: 








LABEL 6 OPERATION & OPERAND 







GU) OUT WORK, . pp type Pep Pa a 
ps es eb ee ete ge peek pee pl] 














1. Places the record in the area whose label is OUTWORK, as 
the next output record of the file described in the DTF macro 
instruction whose label address has been loaded into register 1. 


3.3.3.1. Variable-Length, Blocked Records 


The user must determine the size of the output record and must include the size 
at the beginning of the record before issuing the PUT macro instruction. Logical 
IOCS calculates the block size and enters it in the block before writing. The user 
may not access the first four bytes which are reserved for block size. 


The user is reminded that for sequential disc output files, an eight-byte count 
field is included in the I/O area. These bytes precede the four bytes allocated 
for the block size and are not available to the user for data. 


If the record is built in a work area when a PUT macro instruction is issued, 
logical IOCS determines whether this record fits in the I/O area. If it does not 
fit in the I/O area, logical IOCS writes the block, then starts a new block with 
the current record. If the record fits, it is added to the current block being built. 


If the records are built directly in the I/O area, the user must determine whether 
the current record fits the area before forming the record. Logical IOCS supplies 
the amount of residual space after each PUT operation in the register specified 
by the VBLD keyword parameter. Should the residual space be inadequate, a 
TRUNC macro instruction (see 3.3.5) must be employed. Then the user has a full 
block area available for forming the record. 


3.3.3.2. Undefined Records 


Undefined records are assumed by logical IOCS to be unblocked. The size of these 
blocks must be given to logical IOCS in the register specified by the RCSZ keyword 
parameter. This is expected with each PUT macro instruction. 


3.3.4. RELSE Macro Instruction 


This macro instruction is used with blocked input records from tape or direct access 
storage devices. It permits the user to skip the remaining records in the current block. 
The next GET macro instruction makes the first record of the succeeding block available. 


The format of the RELSE macro instruction is: 


LABEL 6 OPERATION 5 OPERAND 


filename 
[name] 


(1) 
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POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTF (Define The File) macro instruc- 
tion in the program. 


(1) — indicates that register 1 has been preloaded with the address of the 
declarative macro instruction. 


Example: 







LABEL 6 OPERATION 6 


10 


OPERAND 











16 


taper trai ir tirii dl 
eee yey oie ge a ee ae ee a 









1. Causes the next GET macro instruction to ignore any additional records in 
the block currently being processed in the file described by the DTF macro 
instruction whose label address is in register 1. The next GET macro instruc- 
tion for this file will make available the first record of the next sequential 
block. 


3.3.5. TRUNC Macro Instruction 


This macro instruction is used with blocked output records for tape or direct access: 
storage devices. It permits the user to write short blocks of output data. The starting 
address of the next available output I/O area is the current area address after the 
TRUNC macro instruction is used, and TRUNC resets the IORG register to point 

to this area. 


The TRUNC macro instruction must be used with variable-length, blocked records 

that are built in the output area to indicate to logical IOCS that the block is to 

terminate at this point. When a PUT macro instruction is issued after a variable-length 
record has been built, logical IOCS supplies the user with the number of bytes remaining 
in the output area in the general register specified by the keyword parameter VBLD. If 
the user determines that the next variable-length record does not fit, a TRUNC macro 
instruction must be issued to write the output block. The entire output area is then 
available, and the number of available bytes is in the VBLD register. 


The format of the TRUNC macro instruction is: 


LABEL 6B OPERATION 6 OPERAND 
filename . 
{name] 
(1) 





POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTF (Define The File) macro instruc- 
tion in the program. 


(1) — indicates that register 1 has been preloaded with the address of the 
declarative macro instruction. 
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LABEL 6B OPERATION & OPERAND NY 
1. 
(i fas ped ee pet sl i prey apf ee 
peat toa ee Pa ta Pa 
1, Sends to the output device the block of records accumulated by PUT macro 
instructions since the last TRUNC was issued or since a full block of records 
was sent automatically to the output device for the file described in the DTF 
macro instruction whose label is OUTPUT. 
3.3.6. CNTRL Macro Instruction 
This macro instruction provides commands for direct access storage devices, magnetic 
tape units, card punches, and printers. These commands refer to operations such as 
seeking to the next block of records, rewinding tape, card stacker selection, and 
Spacing or skipping on the printer. 
In the case of a direct access storage device, logical IOCS issues a seek to the 
current track being processed. 
The keyword parameter CNTRL=YES must be included in the declarative macro instruc- 
tion for that file whenever the CNTRL macro instruction is to be issued for the file by 
the problem program. The DIT FMT macro instruction does not require this keyword 
parameter specification. wg 


The third and fourth positional parameters are used with a printer file. Either m orn 
may be omitted; however, specifying both m and n causes spacing or skipping to take 
place before and after printing the line. (Execution time is minimized if forms are 
positioned after printing.) The specification of n for paper advancement after printing 
overrides the normal space advance specified by the printer advance keyword parameter 
(PRAD=n) for one print line only. If multiple CNTRL macro instructions for paper 
advance after printing are issued between the execution of successive PUT macro 
instructions, only the last CNTRL macro instruction is executed. 


The format of the CNTRL macro instruction is: 










&B OPERATION 6 OPERAND 





filename 
,code |, 


(1) n 






[name] 


POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTF (Define The File) macro instruc- 
tion in the program. 


(1) — indicates that register 1 has been preloaded with the address of the 
declarative macro instruction. 
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POSITIONAL PARAMETER 2 


code — is the mnemonic code of the command to be performed (see Table 3—12). m= 


POSITIONAL PARAMETER 3 


m — is the immediate carriage control on the printer; spacing or skipping 
takes place before printing. 


n — specify 2 to select stacker 2; 3 to select stacker 3. If blank, document ~q=_ 
goes to reject stacker 1. 


POSITIONAL PARAMETER 4 


n — applies to delayed skipping or spacing; spacing or skipping takes 
place after printing. 
Examples: { 
LABEL & OPERATION OPERAND 6 COMMENTS 
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PRIN TZ, SK 15) tt pada tin 
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NY 
i T 
CNT RL ({F i 10 nya me 18S. 3 4 SELEC STACKER (3 | 
(1) 
MNEMONIC | PRINTER CONTROL | DOCUMENT 
vere CODE IMMEDIATE] DELAY | CONTROL 


Magnetic Tape Rewind Tape 

Units Rewind and Unload Tape 
Erase Gap (Writes Blank Tape) 
Write Tape Mark 
Backspace to Interrecord Gap 
Backspace to Tape Mark 
Forward Space to Interrecord Gap 
Forward Space to Tape Mark 


rit 




















Row Punch Select Stacker 
(Type 0604) 


Drum Printer Carriage Space (a) Lines 
(Type 0768) Skip to Channel (b) 


UNIVAC 8411 Perform Seek to Current Track 
and 8414 Disc of Data 
Subsystem 


2703 Optical Select Stacker 
Document 
Reader 





NOTE: It is recommended that stacker selection on the ODR be employed in a single programming 
environment due to the timing considerations involved. 


ee LEGEND: 4 


a=1, 2, or 3; 0 is not permitted 


b = 4 through 15 


Table 3-12. CNTRL Macro Instruction Parameter List 
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LBRET Macro Instruction 


When the user has a special routine to process additional user standard or non- 
standard labels, control is returned to logical IOCS by means of a LBRET macro 
instruction after label processing is completed. 


The format of the LBRET macro instruction is: 


LABEL 6B OPERATION 5 OPERAND 





POSITIONAL PARAMETER 1 


1 — informs logical IOCS that the user’s label processing is finished. For input 
files, this prevents any more user labels from being read; for output files, it 
causes a tapemark for magnetic tape or an EOF record for disc to be written. 
Control should be returned to logical IOCS and not returned to the address 
supplied by the LBAD keyword parameter. 


2 — requests that control be returned to LBAD after reading in the next label for 
the user to process, or after writing the label the user generated. 


Example: 


LABEL 6 OPERATION 6 OPERAND 


1. Causes a return to the OPEN or CLOSE transient routine 
currently in control and causes that routine to read or write 
another label, then returns control to the address specified 
by the LBAD keyword parameter. 


On sequential disc or tape input with standard labels, when LBAD is entered, a 
user label (80 bytes in length) has been read into the I/O area and register 1 points 
to that label. Register 0 contains an O, F, or V EBCDIC character describing an 
open (O), end-of-file (F), or end-of-volume (V) condition, respectively. When the 
label has been checked, the user returns with a LBRET1 or LBRET2 macro 
instruction, and register 0 has no significance. 


On tape input with nonstandard labels, when LBAD is entered, a user label (BKSZ 
in length) has been read into the I/O area and register 1 points to that label. 
Register 0 contains either an EBCDIC O or E character, describing an open (O) 

or end-of-tape (E) condition. When any label has been checked during the OPEN 
processing, the user returns with LBRET1 or LBRET2, and register 0 has no 
significance. However, during the CLOSE processing when the user returns by 
means of LBRET1 or LBRET2, register 0 must contain either the EBCDIC character 
EV or EF, describing either an end-of-volume (EV) or end-of-file (EF) condition. 
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On sequential disc or tape output with standard labels, when LBAD is entered, a 
user label (80 bytes in length) should be placed in the 1/0 area, as designated by 
register 1. Register 0 contains an EBCDIC O, F, or V character describing an open 
(O), end-of-file (F), or end-of-volume (V) condition, respectively. When the label to 
be written has been placed in the I/O area, as designated by register 1, the user 
returns by means of LBRET2, so that the label can be written. When no more labels 
are to be written, the user must return by means of LBRET1. Register 0 has no 
significance upon return, 


On tape output with nonstandard labels, when LBAD is entered, a user label should 
be placed in the 1/0 area, as designated by register 1. Register 0 contains an 
EBCDIC O, F, or V character describing either an open (O), end-of-file (F), or end- 
of-volume (V) condition. When the label to be written has been placed in the I/O 
atea as designated by register 1, and the length of the label is in register 0, the 
user returns by means of LBRET2 so that the label can be written. When no more 
labels are to be written, the user must return by means of LBRET1. 


The following charts outline various label processing conditions encountered for tape 
and sequential disc files. 


m Tape Output 


OTF LABEL LABEL ENTER cn WITH LENGTH BLOCK USER EXITS LBAD WITH 
SPECIFICATIONS BLOCK |}  REGI | (BYTES) WRITTEN FROM | REGO REG 1 (LBRET) 






















































STO — LBAD No Entry Transient No Exit 
No Entry Transient No Exit 
No Entry Transient No Exit 
No Entry Transient No Exit 
1OA1 (or 2) 1OA1 (or 2) 
IOA1 (or 2) 1OA1 (or 2) 
1OA1 (or 2) 1OA1 (or 2) 
1OA1 (or 2) IOA1 (or 2) 
1OA1 (or 2) tOA1 (or 2) 
A 
NSTD — LBAD All Headers 1OA1 (or 2) OA] (or 2) 








All Trailers 1QOA1 (or 2) 1OA1 (or 2) 






*The user places the nonstandard label to be written in IOA1 or 1OA2 and exits from the LBAD routine with the byte count 
specified as a binary number in register 0. 
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@ Tape Input (Read Forward) 

































































































eel 
DTF LABEL LABEL ENTER LBAD WITH LENGTH BLOCK USER EXITS LBAD WITH 
SPECIFICATIONS BLOCK pREGO =] REGT | (BY TES) READ INTO | REGO REG 1 (LBRET) 
STO = LBAD VOL1-8 No Enitry Transient No Exit 
HDR1 No Entry Transient No Exit 
EOF] No Entry Transient No Exit 
EOv1 No Entry Transient No Exit 
HDR2-8 IOA1 (or 2) 1OA1 (or 2) lor2 
UHL1-8 1OA1 (or 2) 1OA1 (or 2) lor2 
EOF 2-8 IOA1 (or 2) 1OA1 (or 2) lor2 
E0V2-8 IOA1 (or 2) 1OA1 (or 2) 1 or 2 
UTL1-8 IOA1 (or 2) IOA1 (or 2) lor2 
NSTD — LBAD All Headers IOA1 (or 2) 1OA1 (or 2) 2 (if TM)** 
1 of 2 (no TM) 
All Trailers IOA1 (or 2) IOA1 (or 2) lor2 
* The Open or Close transient routine searches for a tape mark. If it is not found within 20 seconds, the transient is closed 
and the job cancelled. (The user must specify LBAD when no tape mark follows nonstandard labels.) 
**If a tape mark follows nonstandard labels, the user passes all labels (whether checking or not) by issuing LBRET 2 until 
the transient reads a tape mark and concludes Jabel checking. If a tape mark does not follow nonstandard labels, the user 
passes all labels (whether checking or not) by issuing LBRET 2 until he recognizes that the last label has been read. 
The user then issues LBRET 1 and the transient conclude’s label checking (with the first data record). If there are 
no header tabels, and no tape mark (LBAD desired to process trailer labels), LBAD has been entered with the first data 
record read. The user must issue CNTRL (backspace) to position the tape at the first data record and exit with LBRET 1. 
a Tape Input (Read Backward) 
ee 


DTF LABEL LABEL ENTER LBAD WITH LENGTH BLOCK 


STD - LBAD No Entry 80 Transient No Exit 
No Entry Transient No Exit 
No Entry Transient No Exit 

1OA1 (or 2) 1OA1 (or 2) 

IOA1 (or 2) 1OA1 (or 2) 


{OA1 (or 2) 1OA1 (or 2) 
IOA1 (or 2) IOA1 (or 2) 


NSTD = LBAD All Trailers 1OA1 (or 2) 


Ali Headers {OA1 (or 2) 
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@ Sequential Disc Output 












OTF LABEL LABEL ENTER LBAD WITH LENGTH BLOCK USER EXITS LBAD WITH 
SPECIFICATIONS KEY p REGO | OREG I | (BYTES) | WRITTEN FROM ; REGO REG | (LBRET) 


LBAD UHL1-8 0 toAl 80 Transient lor2 
UTLO-7 Forv 10A1 80 


m Sequential Disc Input 


OTF LABEL LABEL ENTER LBAD WITH LENGTH BLOCK USER EXITS LBAD WITH 
SPECIFICATIONS KEY | REGO | REG! | (BY TES) READ INTO | REGO | REG | (LBRET) 


LBAD UHL1-8 0 10A1 80 OAL lor2 
UTLO-7 Forv IOA1 80 10A1 lor2 


3.3.8. CLOSE Macro Instruction 





Transient 




















When all the data in a file has been processed, a CLOSE macro instruction should be 
issued. This macro instruction initiates the termination procedures for the file. 


The format for the CLOSE macro instruction is: 









6 OPERATION & OPERAND 





filename 
filename-1,filename-2,...,filename-n 


(1) 


[name] 


POSITIONAL PARAMETER 1 


filename — is the label(s) of the corresponding DTF (Define The File) macro 
instruction(s) in the problem program. 


(1) ~— indicates that register 1 has been preloaded with the address of the 
declarative macro instruction. 


Example: 








LABEL & OPERATION 6 OPERAND 








SE] {I.N,P.UT 


pore te pra Pere ete a bee pa tai b 


L,0, 














1. Enters the transient routine which closes the file described in the DTF macro 
instruction whose label is INPUT. 
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FEOV Macro Instruction 


This macro instruction causes end-of-volume procedures to be initiated on an input 

or output file when a user wishes to discontinue the processing of the current volume 
of the file and begin processing the next volume. The FEOV macro instruction applies 
only to magnetic tape and direct access storage devices. 


Processing of input records is discontinued immediately when the FEOV macro instruc- 
tion is issued for an input file. Since the end of a volume presumably has not been 
reached, the end-of-volume label checking procedures appropriate to the device are 
bypassed for magnetic tape. Direct access devices permit user label processing. When 
the device is a magnetic tape, the tape is rewound with interlock. A volume swap 
occurs and the succeeding volume is opened. The next GET macro instruction accesses 
the first record on the next volume of the input file. 


Processing of output records is discontinued immediately when a FEOV macro instruc- 
tion is issued. Any data which has been passed to logical IOCS by means of the PUT 
macro instruction is sent to the device either as a full or truncated block. The normal 
end-of-volume label procedures are accessed as if the end of a volume has been reached. 


The volume swap then occurs and the next volume is opened. For a magnetic tape 
device, the current volume is rewound with interlock. For a direct access storage 
device, the last record entry field in the format 1 label (file header label) is updated 
to reflect the last valid record on the current volume. The FEOV macro instruction 
may not be issued during user label processing procedures. For sequential files 
(tape or disc), FEOV must not be issued for the last volume of a multivolume file. 
Otherwise, fatal errors are detected by logical IOCS. 


The format of the FEOV macro instruction is: 






B OPERATION 5 





OPERAND. 


filename 





[name] 


(1) 
POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTF (Define The File) macro instruc- 
tion in the program. 


(1) — indicates that register 1 has been preloaded with the address of the 
declarative macro instruction. 


OPERAND 











Fs OO eC DO | 


Poe a bp Pa a ba 














1. Causes the file described by the DTF macro instruction, whose label is 
INFILE, to be treated as if an end-of-volume sentinel had been accessed. fy 
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3.4. DATA MANAGEMENT ERROR ANALYSIS ROUTINE (DMEAR) 


The purpose of the Data Management Error Analysis Routine (DMEAR) is to provide the 
Data Management user with printed information concerning the nature of a fatal hardware 
or logical error which has occurred in opening, processing, or closing a Data Management 
file of any type. 


The DTF macro call of all Data Management files has the optional keyword parameter: 
ERROR=symbol 


where symbol is the label of the user’s error handling routine. The Data Management Error 
Analysis Routine is intended to be called in this error handling routine by the proc 

DMEAR. A typical error handling routine might consist of the DMEAR and CANCEL macro 
calls. 


DMEAR prints system information, file information, and (if an I/O error has occurred) 
I/O information on the system list (SYSLST) device or, optionally, on the console 
printer. 


= CALLING PROCEDURES 


The DMEAR macro call inserted in the user program’s error handling routine will 
initiate the error analysis. General register 0 contains the reason (error code) 

for the error and is loaded by Data Management before passing control to the 

error address. Control is returned to the user program at the instruction follow- 

ing the DMEAR macro expansion. Registers 0 and 1 are restored. The various forms 
of the macro call are: 





LABEL B OPERATIONS OPERAND 


filename 
{ (1) } con) 











POSITIONAL PARAMETER 1 
filename — is the label of the DTF macro call in the user’s program. 


(1) — indicates that register 1 has been preloaded with the address of the 
declarative macro instruction. 


POSITIONAL PARAMETER 2 


CON — causes the error analysis text to be output to the console printer 
if the SYSLST device is unavailable at execution time. 


= CONSOLE OUTPUT 


The text output of the error analysis routine goes to the SYSLST device if that device 
is available at execution time. By including the CON parameter to the DMEAR macro 
eall, the user can cause the error analysis text to be output to the console printer 

Ne if the SYSLST device is unavailable at execution time. The conditions which will cause 
the SYSLST device to be unavailable to the error analysis routine are: 
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— The SYSLST device is being used by another program. 
— OPTION NODUMP is in effect. 


— OPTION MAYIDUMP is in effect and the operator’s reply to ‘SV51 DMEAR REQUIRED?’ 
was NO. 


All console messages output by the error analysis routine have the message prefix DM. 
— See the UNIVAC 9400 Operations Handbook Operator Reference, UP-7871 (current version). 


® RESTRICTIONS 


— The two low order bytes of general register 0 should not be altered between the 
ERROR=symbol address and the DMEAR macro call. 


— If the address passed to the error analysis routine in general register 1 is not 
within the user program’s boundaries, control is returned immediately to the user 
with no error indication and no printed output. If register 1 contains an address 
within the user program’s boundaries but not a valid DTF address, the results 
are unpredictable. 


— Under DOS operation, the PROG NAME (part of the DM02 console message) will be 
incorrect if an RDFCB has used the CCB in the user job’s preamble before the 
error analysis routine is called. 


— If the CCW chain pointed to by the user’s Data Management file CCB begins 
below the user job’s preamble (e.g., in a transient area), that chain will not 
be printed. In addition, the ERR CCW and CMD printed may be in error. 


— The error analysis routine will not analyze chained BCW’s. 


— In order to minimize console printer use, CCW chains and DATA are not output 
to the console. 


— If the SYSLST device is unavailable to the error analysis routine and the user 
has not permitted console output by including the CON parameter to the DMEAR 
macro call, control is returned immediately to the user with no error indication 
and no printed output. 


( 
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4. NONSEQUENTIAL FILE 
PROCESSING 


4.1. DIRECT ACCESS METHOD 


The direct access method allows the user of a direct access storage subsystem to 
process a file in either a random or sequential manner. 


The method of accessing a record in such a data file is specified by the user either 

by means of a key field to match one recorded on the disc, or by means of an iden- 
— tification address in absolute or relative form. When a key field is specified, the 

data within the file is searched for a record with a matching key. When an identifica- 

tion address (ID) is specified for a record, the absolute address form represents the 

actual location of the record on the direct access storage device. The relative form 

of addressing is used when the relative position of the record within the file is known. 


The basic imperative macro instructions are READ and WRITE, which permit records 
to be read, written, replaced, or deleted at specific points within a file. When a READ 
or WRITE macro instruction is issued, the requested I/O operation is either initiated 
immediately or placed on a wait list for later execution. To ensure that the requested 
I/O operation has been successfully completed, a WAITF macro instruction must be 
issued prior to the next I/O request. The WAITF macro instruction tests for successful 
completion of any READ or WRITE operation. 
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4.1.1. Declarative Macro Instruction 






A file to be processed by the direct access method must be defined in the problem 
program by the declarative macro instruction, DIFDA. The symbolic name of the 
file (filename) may have a maximum of seven characters, and is used by the impera- 


tive macro instructions to identify the file. 


To enable the user to link his program with a DTFDA table generated in a separate 
assembly, the following references are generated by this macro instruction: 


w An ENTRY definition for filename. The user must supply an EXTRN definition 


for filename within his program. 


mw An EXTRN definition for each label supplied by parameters ERRBYTE, IOAI, 
SEEKADR, ERROR, IDLOC, KEYARG, LBAD, and XTNTXIT. The user must 
also supply ENTRY definitions for these labels in his program. 


Following is a listing in alphabetic order of the required and optional keyword 
parameters which may appear in the operand of the DTFDA macro instruction. A 
description of each keyword parameter follows the listing. A summary of the keyword 
parameters is given in Table 4—4 at the end of the descriptions. 


LABEL t OPERATION 6b 


filename 





OPERAND 


“BKSZ-n 


ERRBYTE=symbol 
IOAl=symbol 


FIXUNB 
rcrM= [oro 
SEEKADR=symbol 

INPUT 
TREY (ocr oa 


[AFTER=YES] 
[CNTRL=YES] 
8411 
DEVICE=< 8414 
8424 
[ERROR=symbol] 
[HOLD-YES] 
{IDLOC=symbol] 
[KEYARG=symbol] 
{KEYLEN=n] 
{[LBAD=symbol] 
{[READID=YES] 
[READKEY-YES] 
[RCSZ=(1)] 


frevarive- f§] 


T 
{[SRCHM=YES] 
[VERIFY=YES] 
{WRITEID=YES] 
[WRITEKEY=YES| 
[XTNTXIT=symbol] 


NOTE: Assembler rules concerning commas and continuation of parameters in the 


operand field apply when writing this macro instruction; see 1.2. 
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mw AFTER Keyword Parameter 











ea 
The following keyword parameter is specified if a subsequent WRITE macro 
instruction contains an AFTER or an RZERO positional parameter. A format write 
is involved. 
AFTER=YES 
m Block Size 
This keyword parameter specifies the size of the I/O area and has the following 
format: 
BKSZ=n 
where n is the size of the I/O area in bytes. This keyword parameter is required. 
The size requirements of the I/O area are determined by four factors: 
(1) The length of the data to be read or written. If the format is variable, the 
maximum size of the data should be provided. 
(2) The size of the key. This depends on whether the keyword parameter KEYLEN 
is specified and one of the following keyword parameters is specified: 
AFTER, READID, or WRITEID 
(3) The size of the count area (eight bytes). This must be included if the keyword 
parameter AFTER is specified. 
4 
(4) A maximum size of 3625 bytes for the UNIVAC 8411 Disc Subsystem or 7295 
bytes for the UNIVAC 8414 and 8424 Disc Subsystems. This maximum size <_ 
does not include the eight bytes required if AFTER is specified. 
Requirements for minimum sizes are described subsequently in this section at 
Input/Output Area (IOAL=symbol.) 
These storage requirements are illustrated in Figure 4-1. 
1OAl Count Key Data 
(8 bytes) (KEYLEN=n) (Largest Record) 
BK Zt OOO eee 
CREATE A FILE OR WRITE ADDITIONAL RECORDS IN A FILE: 
RECORDS WITH KEY AREAS 
AFTER=YES 
KEYLEN is specified 
WRITEID or READID may be specified 
WRITEKEY or READKEY may be specified 
—. 


Figure 4—1. Schematic of Formats for [OAT in Main Storage 
(Part 1 of 2) 
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Count Data 
(8 bytes) (Largest Record) 


IOAI 





eS 


RECORDS WITHOUT KEY AREAS 
AFTER=YES 
KEYLEN is not specified 
WRITEID or READID may be specified 
WRITEKEY or READKEY may not be specified 


Data 
10Al 


(Largest Record) 





a Ct ad 


READ OR WRITE (UPDATE) BY KEY, OR BY ID: 
AFTER is not specified 

and 1) KEYLEN is not specified. 
READID or WRITEID is specified. 
READKEY or WRITEKEY is not specified. 

or 2) KEYLEN is specified. 
READKEY or WRITEKEY is Specified 
READID or WRITEID is not specified. 


Key Data 


10A1 (KEYLEN=n) (Largest Record) 





fe SZ 


READ OR WRITE (UPDATE) BY ID: 
AFTER is not specified. 
KEYLEN is specified. 
WRITEID or READID is specified. 
READKEY or WRITEKEY may be specified. 


Figure 4—1. Schematic of Formats for [OAT in Main Storage 
(Part 2 of 2) 
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a Control Entry 


be 
The following keyword parameter specifies that a CNTRL macro instruction is to 
be issued by the problem program. 
CNTRL=YES 
The orders associated with the CNTRL macro instructions are executed only for 
nonshared units; otherwise, they are ignored. 
m Device Type 
The keyword parameter that defines the type of device upon which the data file 
exists is: 
8411 
DEVICE=< 8414 hee 
8424 
where 8411 represents the UNIVAC 8411 Disc Subsystem, 8414 represents the 
UNIVAC 8414 Disc Subsystem, or 8424 represents the UNIVAC 8424 Disc <_ 
Subsystem. 
This is not a required parameter; the OPEN transient routines determine the 
device characteristics from the Physical Unit Block (PUB) device type of the <—_ 
first volume. All other volumes of the file must be consistent with the first. 
. w Error Status Codes 
Nee” 


The user must provide the address of a two-byte field into which logical IOCS 
can set error conditions by means of the following keyword parameter: 


ERRBYTE=symbol 


where symbol (label) is the address of a two-byte field to contain the error codes. 
The codes are made available by the WAITF macro instruction for user testing. 
Table 4—1 summarizes the possible return codes. 
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BIT ERROR/STATUS CODE REASON FOR SETTING 


Wrong length (1) READ Instructions 
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(a) By KEY 


— FIXED — data size of disc record 
differs from data size specified. 


— UNDEF — data size of disc record 
is greater than maximum data size 
specified. 


By ID 


— FIXED — if KEYLEN > 0 and key size 
of next record on track differs from key 
size specified, or data size of next 
recard on track differs from data size 
specified. 


— UNDEF — key size of disc record 
differs from key size specified if 
KEYLEN > 0, or data size of disc 
record is greater than maximum data 
size specified. 


(2) Data WRITE Instructions 
(a) By KEY 


~ FIXED — data size of disc record 


differs from data size specified. Newel 


— UNDEF* — data size of record to be 
written is greater than maximum data 
size specified. 


(b) By ID 


— FIXED — if KEYLEN > 0 and key size 
of next record on track differs from key 
size specified, or data size of next 
record on track differs from data size 
specified. 


UNDEF* — data size of record to be 
written is greater than maximum data 
size specified. 


(3) Format WRITE Instructions 


(a) With AFTER specified 


~ FIXED — is meaningless. 


— UNDEF — data size of record to be 
written is greater than maximum data 
size specified. A check is made before 
the instruction is issued and only maxi- 
mum data size is written. 


With AFTER, EOF specified — is mean- 
ingless. 


With RZERO specified — is meaningless. 





*Check is made before instruction is issued and only maximum data size is written. 


Table 4-1. Error Status Codes for Direct Access Method 
(Part 1 of 3) 
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Track not locked 


No room found 


Track locked 


Lockout table full 


Data Check-Count Area 


Track overrun 


End of cylinder 
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This indicator is set after a RELEX macro instruction 
if the track to be released was not found in the lockout 
table for that job. It is not set if the ALL positional 
parameter has been specified. 


This indicator is set when a WRITE macro instruction 
using the AFTER positional parameter has been requested 
and there is not enough room on the track for this record. 
No part of the record is written and the capacity record 
(RO) is not altered. This bit should never be set when 
using the keyword parameter RELATIVE=R and the AFTER 
positional parameter of the WRITE macro instruction in 
combination. 


This indicator is set when a READ macro instruction with 
the H positional parameter or a WRITE macro instruction 
was issued and another job has an entry in the lockout 
table for the address in the SEEKADR parameter. The 
user is responsible for re-issuing the order. This indicator 
is not set unless HOLD=YES has been specified. 


This indicator is set when a job attempts to make an entry 
into a full lockout table. The user must reissue the order. 
This condition may cause an indefinite loop if the user 
continues to reissue the command. The problem may be 
caused by inadequate table size or by failure to release 
entries made by any job in the system. 


Unrecoverable error. 

If this error occurs, the requested WRITE or READ has 
not been successfully completed. The user should either 
ignore this record, if possible, or terminate processing 
of the file. 


This bit is set when a WRITE macro instruction with 
the AFTER positional parameter is executed and more 
data remains to be written than will fiton the track. If 
this error occurs, some part of the count, key, and/or 
data has been written but the capacity record (RO) has 
not been updated. This is a programming type error. 


This bit is set when an order associated with a READ 

or WRITE macro instruction with a KEY positional 
parameter, and the search multiple option is active, is 
issued and the record is not found before reaching the 

end of the cylinder. Byte 1, bit 4 will also be set. This 
condition applies to both absolute and relative addressing. 


This bitis also set if the IDLOC keyword parameter is 
supplied and the search multiple option is not involved 
(either the option is not specified or is not allowed, or 
a READ or WRITE macro instruction with ID specified 

has been issued), and 


(1) the next §D is in a different cylinder or 


(2) the next ID is in a different volume 





This setting applies only to absolute addressing. 


Table 4—1. Error Status Codes for Direct Access Method (Part 2 of 3) 
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ERROR/STATUS CODE 


Data check in key 
or data 


Record not found 


End of file 


End of volume 


Invalid ID; record not 
in specified extents 


Table 4-1. 
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REASON FOR SETTING 


Unrecoverable error. 

If this error occurs, the requested WRITE or READ macro 
instruction has not been executed. The user should ignore 
this record if possible or terminate processing of this file. 


This indicator is set when the order associated with a 
READ or WRITE macro instruction with a KEY or ID 
positional parameter does not find the specified record. 
This bit may also be set in conjunction with the end-of- 
cylinder bit (see byte 1, bit 2). 


If this bit is set when the keyword parameter RELATIVE=R 
is specified, a record has not been found in the specified 
location. 


This bit is set when the order associated with a WRITE 
macro instruction with an 1D or KEY positional parameter 
is executed and the referenced disc record has a data 
length of 0. This bit is also set when the order associated 
with a READ macro instruction references a disc record 
with a data length of 0. 


When this bit is set, the ID returned is all 1 bits, if the 
IDLOC keyword parameter is specified. 


If the absolute address at the location defined by the 
SEEKADR keyword parameter is physically nonexistent, 
this bit is set. 


When the keyword parameter IDLOC is specified, this bit 
is also set in conjunction with the end-of-cylinder bit if: 


(1) The next ID is on the next volume. 


(2) The record read or written was the last record in 
the file. (Ali 1 bits are supplied in the location 
defined by the IDLOC keyword parameter.) 


If the keyword parameter RELATIVE is specified, this 
bit is set only for a record or track number higher than 
the number of records or tracks in the file. If the AFTER 
positional parameter of a WRITE macro instruction and 
RELATIVE=R are both specified, this bit may be set 
when the record to be written is not the next record 

that should be written on the requested track of the - 

file. If RELATIVE is not specified, this bit is set 

when the address at the location defined by the SEEKADR 
keyword parameter is not in the user’s extents. 


Error Status Codes for Direct Access Method 


(Part 3 of 3) 
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mw Major File Error 


~~ When a fatal hardware or detectable logical error occurs on a file, the user may 
have control transferred to a special error handling routine by specifying the 
following keyword parameter: 


ERROR=symbol 
where symbol (label) is the address‘ of the error handling routine. 


When the user gets control at this address, the file is not marked as being OPEN 
and registers 1 through 12 have been restored. Register 0 contains the following 
information concerning the reasons for the error: 


~ Bytes 0 and 1 reflect the first and second hardware sense bytes if the error 
is a hardware error; otherwise, these bytes contain binary 0’s. 


— Byte 2 contains a one character EBCDIC value indicating in what section of 
processing the error occurred, where 4 = transients (such as OPEN) and 1 = 
processing (such as READ, WAITF, WRITE, or CNTRL). 


~— Byte 3 contains a one character EBCDIC value indicating the reason for the 
error; refer to Appendix E. 


The OPEN transient routine causes an informational typeout, inserting bytes 2 and 

3 as xx in the standard Data Management message format (DMxx). The CLOSE transi- 

ent also causes informational typeouts for detectable logical errors, but control is 

returned to the user at the instruction following the CLOSE macro instruction rather 
SS than at the ERROR address. 


If control is passed to the ERROR address from a processing macro instruction 
(READ, WRITE, CNTRL, or WAITF), the address of the instruction following 
that macro call can be found in register 14. In the case of the OPEN transient 
routine, register 14 is restored to the value in the register preceding the OPEN 
call. 


If this keyword parameter is not specified, the OPEN transient routine causes the 
informational typeout on the console, stores the above register 0 information in the 
DTF table at location DC$ERR, and then executes abort procedures when a major 
file error occurs. 


If this keyword parameter is not specified and a detectable logical error occurs, the 
processing macro instruction (READ, WRITE, CNTRL or WAITF) stores the register 

0 information in the DTF table at location DC$ERR and then executes abort procedures. 
However, if this keyword parameter is not specified and a fatal hardware error occurs, 
abort procedures are executed. These major file errors do not coincide with those set 

in the error status codes (ERRBYTE). 


m Track Protection 


Prevention of the address specified in the SEEKADR parameter from being accessed 
by more than one job is accomplished by specifying the following keyword para- 
meter: 


HOLD=YES 
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This parameter is used only when the Supervisor has the facility for handling record 
lockout. When this parameter is specified, the execution of the READ and WRITE 
imperative macro instructions is affected as follows: 


— All WRITE macro instructions (format and update forms) check the lockout table 
for the address in the SEEKADR parameter. If another job has made an entry 
for this track, the TRACK LOCKED bit in ERRBYTE is set and the command 
is not issued. The user is responsible for reissuing the command. If an entry 
has not been made for the track, an entry is made and the command is issued. 
A WRITE macro instruction removes the entry from the lockout table after 
completion of a command whether or not the command was successfully executed. 


NOTE: A WRITE filename,KEY statement is used to protect only the track 
specified in the SEEKADR parameter; therefore, if the SRCHM para- 
meter option is used, the track being accessed may not be protected. 


— A READ macro instruction with the H positional parameter specified checks 
the lockout table for the address in the SEEKADR parameter. If an entry has 
been made by another job, the TRACK LOCKED bit of ERRBYTE is set and 
the command is not issued. The user is responsible for reissuing the command; 
otherwise, an entry is made in the lockout table. A job may make more than 
one entry for a track. 


NOTE: A WRITE filename,KEY statement is used to protect only the track 
specified in the SEEKADR parameter; therefore, if the SRCHM para- 
meter option is used, the track being accessed may not be protected. 


A READ macro instruction without the H positional parameter allows commands 
to be issued regardless of whether HOLD=YES is specified in the DTFDA macro 
instruction. 


CNTRL=YES must not be specified if HOLD=YES is specified. The latter specifi- 
cation implies a multiprogramming environment with a shareable disc device. The 
Supervisor does not accept the CNTRL macro instruction in such an environment. 


@ Identification Address 


After certain READ or WRITE macro instructions are issued, the record identi- 
fication address (ID) is stored in a five-byte field by specifying the following 
keyword parameter: 


IDLOC=symbol 


where symbol (label) is the address of the five-byte field containing the record 
identification address. The ID may be that of the same record or the next record, 
depending on the macro issued and the SRCHM keyword parameter. The format of 
the ID is the same as that specified for the location defined by the SEEKADR 
keyword parameter. This ID can be used to access the next sequential record of 
a file. If the data length of the referenced disc record is 0, the ID is set to all 
1’s. 
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Table 4—2 shows the various settings for IDLOC after certain macro instructions 


Nese are issued. 


KEYWORD OR RECORD IS THE REFERENCED DISC 
POSITIONAL LAST RECORD RECORD DATA 
PARAMETER NORMAL RETURN IN THE FILE LENGTH=0 


The ID of the next All 1 bits All 1 bits 
record within the file 


READKEY or The ID of the next All 1 bits All 1 bits 
WRITEKEY; record within the file 

SRCHM not 

specified 


READKEY or The ID of the same The ID of the All 1 bits 
WRITEKEY; record same record 

SRCHM is 

specified 


RZERO 
AFTER 
AFTER,EOF 





*Meaningless 


NOTE: \f the file has not been allocated on a cylinder basis, the search multiple option is disallowed even 
if the SRCHM keyword parameter is supplied. 


Table 4~2. Identification Address (1D) Supplied After a READ or WRITE Macro Instruction 


m Input/Output Area 


Each input and output file requires an area reserved for its individual use. This 
area is specified by the following keyword parameter: 


IO0A1=symbol 


where symbol (label) is the address of the I/O area. The length of the area is 
specified by the keyword parameter BKSZ and must be large enough to contain 
the maximum number of bytes required in any READ or WRITE macro instruction 
issued for the file. The minimum number of bytes required is 80 when the keyword 


parameters LBAD and TYPE=INPUT are specified. Otherwise the minimum length 
is 14 bytes. . 


When WRITE macro instructions are issued, logical IOCS assumes that the I/O 
area contains the information implied by the type of instruction. If the AFTER 
poSitional parameter is used with the WRITE macro instruction, logical IOCS 
builds the eight-byte count field for the data being written. 


Table 4—3 shows the contents of the I/O area for a given macro instruction. 
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MACRO INSTRUCTION 1/0 AREA CONTENTS 
OPERATION POSITIONAL PARAMETERS WITH KEYLEN WITHOUT KEYLEN 


filename, KEY Data 
(Logica! 10CS 
supplied) 


filename, ID Key and Data Data 
(Logical iOCS (Logical 1O0CS 
supplied) supplied) 


filename, KEY Data Invalid 
(User supplied) 


filename,ID Key and Data Data 
(User supplied) (User supplied) 


filename,RZERO Anything Anything 
(Logical 1OCS (Logical lOCS does 
does not change not change this area) 
this area) 


filename, AF TERL,EOF] Count (Logical Count (Logical lOCS 
1IOCS supplied) supplied) 
Key and Data Data (User supplied) 
(User supplied) 





Table 4-3. 1/0 Area Contents for Logical |OCS 


w Key Field 


The following keyword parameter specifies that records are to be identified by a 
key: 


KEYARG=symbol 


where symbol (label) is the address of the key field in the problem program. This 
keyword parameter must be used if the problem program issues READ or WRITE 
macro instructions with the KEY positional parameter specified. The KEYLEN 
keyword parameter must also be specified for the same file. The key is used in 
searching for a record with an identical key. 


m Key Length 


When referencing records by key, generating new records with keys, or updating 
(or reading) both key or data areas of records, the following keyword parameter 
should be specified: 


KEYLEN=n 


where n is the length of the key in bytes. All keys in a file must have the same 
length. If this keyword parameter is not specified, a length of 0 is assumed for 
the key. If the length is 0, all keys in the file are ignored even if they are present. 
The maximum length for a key is 255 bytes; the minimum length is three bytes. 
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uw Special Label Handling 


This keyword parameter supplies the address of a user routine to process user 
header labels. The format is: 


LBAD=symbol 


where symbol (label) is the address of the user routine. If user header labels 
exist or are to be written, they are located in the first track of the first extent 
for each volume within the file. Data begins in the second track of the first 
extent. 


If this keyword parameter is not specified, logical IOCS uses the format 1 label 
to determine where data begins. If the first extent of a volume is marked as 
containing labels, data is assumed to begin in the second track of the first 
extent for that volume. If the first extent is marked as not containing labels, 
data is assumed to begin in the first track of the first extent for that volume. 


If both the LBAD keyword parameter and the parameter TYPE=OUTPUT are 
defined, the first extent of each volume is marked as containing user labels. 


Reference should be made to the OPEN and LBRET macros for discussion of 
label processing. 


w Read Record by ID 


If a record to be read is to be located by its address (ID), the following keyword 
parameter must be specified: 


READID=YES 


Logical IOCS expects that READ macro instructions with the ID positional 
parameter will be issued. If KEYLEN > 0, a READ macro instruction with the 
ID parameter will read both the key and data fields of the record. If KEYLEN 
= 0, it will read only the data field (even if a key field exists on the disc). 
Also, the record number specified at the address given by SEEKADR must be 
greater than zero. 


w Read Record by KEY 


If a record to be read is to be located by its key, the following keyword parameter 
must be specified: 


READKEY=YES 


Logical IOCS expects that READ macro instructions with the KEY positional 
parameter will be issued. If the SRCHM keyword parameter is also specified, the 
file must be allocated on a cylinder basis; otherwise, the search for the key is 
on a single track only. The search on key always begins at the address given 

at the location defined by the SEEKADR keyword parameter. A READ macro 
instruction with the KEY positional parameter will read the data field of a 
record only. 
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@ Record Format 
Record formats must be defined. In the direct access method there is no blocking; 
therefore, a record has the same format as a block. There are two types of record 


formats: 


~ RCFM=FIXUNB 
This keyword parameter specifies that the records are of a fixed length. 


— RCFM=UNDEF 


This keyword parameter specifies that records are of variable or undefined 
length and must be used in conjunction with the RCSZ keyword parameter. 
If a key is specified for a record, the length of the key is the same for all 
records. If RELATIVE=R is specified, this option cannot be used. 


If RCFM is not supplied, fixed unblocked records are assumed. 


@ Record Size 


If the data length of records is undefined, the following keyword parameter must 
be specified: 


RCSZ=(r) 


where (r) is the number of the general register (2-12) that contains the data length 

of each record to be read or written. When logical IOCS reads a record, it supplies 

the data length of the record in the specified register during the execution of the 
subroutine called by the WAITF macro instruction. It is the responsibility of the 

user to place the data length of the record in the specified register before issuing neoayi 
a WRITE macro instruction for the record. 


@ Relative Addressing 


A direct access storage device may be addressed either in absolute or relative 
form by the problem program. Relative addressing is the preferred form for several 
reasons: 


(1) Any fragmentation of a file is not known to the user. 
(2) The problem program is not normally affected by the relocation of a file. 


(3) In a multiprogramming environment, one user does not normally control a disc 
pack; therefore, a problem program should operate independently of the exact 
allocation of the files. 


There are two types of relative addressing: 
— RELATIVE=R 


This form of the keyword parameter indicates that the record address (ID) 
given in the location defined by SEEKADR keyword parameter is a relative 
record number. It is applicable only to fixed-length records. The relative 
record number is converted to an absolute address. If the IDLOC keyword 
parameter is specified, the ID returned is a relative record number. A WRITE 
macro instruction with the RZERO positional parameter specified may not be 
issued when RELATIVEER is specified. 
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RELATIVE=T 


This form of the keyword parameter indicates that the record address (ID) 

given in the location defined by the SEEKADR keyword parameter is a 

relative track number. Identification of the precise record on the track 

depends on whether the KEY or the ID positional parameter of the READ 

or WRITE macro instruction is used. If the ID positional parameter is used, 

the record address consists of a relative track number and an absolute 

record number. The record number must be greater than zero. If the KEY posi- 
tional parameter is used, the record address consists of a relative track number 
and the record number is ignored. 


m Seek Address 


The following keyword parameter specifies the address of an eight-byte field in 


the problem program: 


SEEKADR=symbol 


ere symbol (label) is the address of an eight-byte field. When a READ or 


WRITE macro instruction with the ID positional parameter specified is issued, 
the SEEKADR field contains the address on the device of the record to be read 


written, When a READ or WRITE macro instruction with the KEY parameter 


specified is issued, the SEEKADR field contains the address at which the key 
search starts. The value contained in SEEKADR may be expressed in one of 


wh 

or 

thr 

(1) 
Ne 

(2) 


ee ways: 

Absolute Addressing 

The keyword parameter RELATIVE is not specified. 

The address of the record has the following form: 

mbbechhr 

where the fields are described as follows: 

m = Sequential number (1-8) of the volume in the file 

bb = 00 

cc = Cylinder number (0 — 199 for UNIVAC 8411 and 8414 Disc Subsystems, 
or 0 — 399 for UNIVAC 8424 Disc Subsystem) 

hh = Read/Write head number (0—9 for a UNIVAC 8411 Disc Subsystem, or 
0 — 19 for a UNIVAC 8414 or 8424 Disc Subsystem) 

r= Sequential number of the record on the track 

Each field is expressed as a binary value. The user should not address Record 

0 on any track. When a WRITE macro instruction with the RZERO positional 

parameter specified is issued, the record number is ignored. 

Relative Track Addressing 


The keyword parameter RELATIVE=T is specified. 
The address of the track has the following form: 


O00ttttr 
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where: 
000 = Reserved for future use 
tttt = The binary track number relative to the beginning of the file. 
The number of the first track is 1. 
r = The sequential number of the record on the track. This number 


(which must be greater than zero) must be provided when a 
record is referenced by a READ or WRITE macro instruction 
using the ID positional parameter, Otherwise, this byte is 
ignored. 


(3) Relative Record Addressing 
The keyword parameter RELATIVESR is specified. 


The eight-byte address field contains a binary number, right justified, repre- 
senting the relative number of the record to be accessed in the file. Logical 
IOCS converts this number to an absolute address. The number of the first 
record in the file is 1. 


g@ Search Multiple Tracks 


A search on a key is extended to multiple tracks when the following keyword 
parameter is specified. 


SRCHM=YES 


The search is initiated at the address given in the location specified by the 
SEEKADR keyword parameter and continues until either the record is found or 
the end of the cylinder is reached. (The file must be allocated on a cylinder 
basis or this keyword parameter will be disallowed by the OPEN transient 
routine.) 


mw Type of File 
This specification determines the method of label processing to be performed on 
the file. Either of the following options describing the type of file must be speci- 
fied: 
— TYPE=INPUT 


This form of the keyword parameter specifies that standard labels are to be 
read and checked for this file. This option is assumed if the TYPE keyword 
is not specified. 


— TYPE=OUTPUT : 


This form of the keyword parameter specifies that standard labels are to be 
written for this file. 


Refer to Appendix A.2 for discussion of the type of checking and writing done 
in accordance with this parameter. 
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m Verification Requirements 


Ne The following keyword parameter requests that a parity check be made of all 
records after they have been written on the device. 


VERIFY=-YES 


Data Management reads back one byte of data and checks for a successful 
completion to verify that the record transferred was written correctly. The 
hardware cyclic check feature establishes if the transfer was completed 
successfully. Verification of records necessarily increases the execution 
time for the commands associated with the WRITE macro instruction. 


If the keyword parameter is not specified, a parity check of the records is not 
made. 


m Write Record by ID 


The following keyword parameter must be specified if an output record is to be 
located by means of its address (ID). 


WRITEID=YES 


WRITE macro instructions with the ID positional parameter will be issued. If 
KEYLEN > 0, a WRITE macro instruction with the ID parameter will update 
both the key and data fields of the record. If KEYLEN=0, only the data field 
is updated (even if a key field exists on the disc). 


@ Write Record by KEY 


VN The following keyword parameter must be specified if an output record is to be 
located by its key: 


WRITEKEY=YES 


WRITE macro instructions with the KEY positional parameter will be issued. If 
the SRCHM keyword parameter is also specified, the file must be allocated on 

a cylinder basis. Otherwise, the search for the key is on a single track only. The 
search on key always begins at the address given at the location supplied by the 
SEEKADR keyword parameter. A WRITE macro instruction with the KEY positional 
parameter specified will update only the data field of a record. 


mw Special Extent 


The following keyword parameter causes the information in an extent to be passed 
to the user: 


XTNTXIT=symbol 


where symbol (label) is the address of a user routine to process each extent in the 
data file. During the processing associated with the OPEN macro instruction issued 
for the file, logical IOCS transfers control to the specified user routine for each extent 
in the data file and places in register 1 the address of a 14-byte area containing the 
extent information. The user must return control to logical IOCS by means of the 
LBRET macro instruction. If the first extent on any volume is identified as in- 
cluding user labels, the label track is excluded from the extent information 

passed to the user; see 2.3.8 for format details. 
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The format of the 14-byte area follows: 


BYTES CONTENTS 

0 Extent type indicator (binary) 

1 Extent sequence number (binary) 

2-5 Lower limit of the extent, in the form CCHH (discontinuous binary) 
6-9 Upper limit of the extent, in the form CCHH (discontinuous binary) 
10-11 Sequential number (1—8) of the volume in the file (binary) 

12-13 Zeros 


LABEL tb OPERATION & OPERAND 
o: 16 


FOR MAT, OF] (A, DIIRIEC,T, JAC CE S/S, tN PIU, T, Fil 


COMMENTS 





SECTION: 
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Y = One option required 
+ = Assumed parameter, if none specified 
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MACROS 
‘ KEYWORD SPECIFICATION REMARKS 
ones READ] WRITE 
AFTER YES xX A capacity record on each track is 
assumed 
BKSZ n=maximum block size R R Length of IOA1, in bytes 
CNTRL YES x xX Required if CNTRL macro instruction 
is to be used 
DEVICE 8411, 8414, or 8424 x Xx Identifies device — 
ERRBYTE Symbolic label R R Error status byte address 
ERROR Symbolic label x Xx Address of user error routine 
+ HOLD YES x Xx Track protection option 
IDLOC Symbolic label x Xx Address of field for ID 
I0Al Symbolic label R R Name of |/O area defined by user 
KEYARG Symbolic label Xx x Address of field for key used for 
key search 
KEYLEN n=key length x x Length of the key in bytes 
LBAD Symbolic label! x x Address of user label handling routine 
READID YES x Record referenced by ID 
READKEY YES xX Record referenced by KEY 
RCFM FIXUNBI Y Y For fixed-length records; if omitted, 
FIXUNB is assumed 
NS 
UNDEF Y Y Not fixed-length records 
RCSZ (r)=register number xX x For undefined records 
RELATIVE R xX x Relative addressing — record 
T x x Relative addressing — track 
SEEKADR Symbolic tabel R R Address of track reference field 
SRCHM YES x x Search multiple tracks (if specified, 
file must be allocated on a cylinder 
basis) 
TYPE input t Y Y Check standard labels 
OUTPUT Y Y Write standard labels 
VERIFY YES Xx Records check-read 
WRITEID YES Xx Reference by ID ‘ 
WRITEKEY YES Xx Reference by KEY 
XTNTXIT Symbolic label x x Address of extent processing routine 
LEGEND: 
R = Required 
X = Optional 


Table 4—4. Summary of Keyword Parameters for the DT FDA Macro Instruction 
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Imperative Macro Instructions 


Logical IOCS allows records to be accessed by record key or by record identifier. 

If records contain keys, those records can then be accessed by a search for a match 
of the key. Ali records contain an identifier as part of the count area. The identifier 
is actually the address of the record, and access by record identifier is by a search 
for an address match. Access by key or identifier may be either to read or to write 
the record. 


The imperative macro instructions which may be used in the direct access method are 
OPEN, LBRET, READ, WRITE, WAITF, CNTRL, and CLOSE. To access a file, an 
OPEN macro instruction must be executed, and when all processing is completed on 
the given file, a CLOSE macro instruction must be executed. The imperative macro 
instructions are described in detail in the following paragraphs. 


4.1.2.1. OPEN Macro Instruction 


After a file has been defined by the DTFDA declarative macro instruction, the 
OPEN macro instruction must be used to initialize the file before issuing a READ, 
WRITE, CNTRL, WAITF, or CLOSE macro instruction for the file. The OPEN macro 
instruction calls on a transient routine which performs the required operations. The 
function of OPEN is to initialize the file and perform standard label processing. 
Logical IOCS either checks or writes standard labels depending on the type of file. 
Extent information is passed to the user if the keyword parameter XTNTXIT has 
been specified. In addition, if the keyword parameter LBAD is specified, the OPEN 
transient routine either delivers user standard header labels or it writes user 
standard header labels. 


Logical IOCS requires that all volumes of the file be available for use at OPEN 
time. All such volumes are accessed one at a time during the OPEN process. A 
file is opened as input or output according to keyword parameter TYPE in the 
declarative macro instruction for that file. 


mg Input Files (TYPE=INPUT) 


The OPEN transient routine executes the following steps: 


(1) Checks the VOL1 label. 
(2) Checks the VTOC labels. 
(3) Preserves extent information as specified in the VTOC labels. 


(4) If the keyword parameter, LBAD, is specified, logical IOCS delivers each 
of the 80-byte user standard header labels to the user one at a time in the 
1/O area. Register 1 contains the address of the area specified by the IOA1 
keyword parameter. When the user has processed each label, control is returned 
to logical IOCS by means of the LBRET macro instruction. 


(5) The OPEN transient routine delivers all extents to the user one at a time 
in the area specified by the IOA1 parameter if the keyword parameter 
XTNTXIT is specified. Register 1 contains the address of the area speci- 
fied by the IOA1 parameter. After processing each extent the user returns 
control to logical IOCS by means of the LBRET macro instruction. 
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= Output Files (TYPE=OUTPUT) 


The OPEN transient routine executes the following steps: 


(1) Checks the VOL1 label. 
(2) Checks the VTOC labels to see if this file is available for writing. 
(3) Fills in appropriate fields in the standard file labels of the VTOC. 


(4) If the keyword parameter LBAD has been specified, logical IOCS transfers 
control to the user label routine. Upon return from the user label routine 
by means of the LBRET macro instruction, the OPEN transient operation 
writes the user standard header labels. The address of the 80-byte area in 
which the label is built should be supplied in register 0. The OPEN tran- 
sient routine uses the first four bytes of the 80-byte label identifier. The 
other 76 bytes of the label are supplied by the user (see 2.3.8). 


(5) The OPEN transient routine delivers all extents to the user one at a time 
in the area specified by the IOA1 parameter if the keyword parameter 
XTNTXIT has been specified. Register 1 contains the address of the area 
specified by the IOA1 parameter. The user returns to logical IOCS by means 
of the LBRET macro instruction after processing each extent. 


For additional information, see LBRET (4.1.2.6) and XTNTXIT (4.1.1). For 
direct access storage device conventions for user header and trailer labels, 
see 2.3. 


The format of the OPEN macro instruction is: 








6 OPERATIONS | OPERAND 







filename 
filename-1,filename-2,...,filename-n 


(1) 


[name] 


POSITIONAL PARAMETER 1 


filename — is the label(s) of the corresponding DTFDA declarative macro 
instruction(s) in the program. 


(1) — indicates that register 1 has been preloaded with the address of the 
declarative macro instruction. 


Example: 
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4.1.2.2. READ Macro Instruction 


This imperative macro instruction causes a record to be read from the direct access 
storage device into main storage. When control is returned after an operation, the 
data is not necessarily available. The user must issue a WAITF macro instruction 
to ensure that the data has been transferred. The address into which the data is 
read is specified by the keyword parameter IOA1. 


The format of the READ macro instruction is: 


LABEL B OPERATION 5 OPERAND 


filename KEY 
{name] 
(1) ID 





POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTFDA declarative macro instruction 
in the program. 


(1) — indicates that register 1 has been preloaded with the address of the 
declarative macro instruction. 


POSITIONAL PARAMETER 2 


KEY — a search is made for the record with the key matching that defined in 
the location specified by the keyword parameter KEYARG. The search 
begins at the track and cylinder address found in the location defined 
by the keyword parameter SEEKADR. If the keyword parameter SRCHM 
is specified and the file is allocated on a cylinder basis, the search 
continues through the cylinder until either a match is found or the end 
of the cylinder is reached. If the file is not allocated on a cylinder 
basis or the keyword parameter SRCHM is not specified, the search 
is confined to a single track. If the record is found, the data portion of 
that record is read. 


ID — a search is made for a matching ID. (Refer to the SEEKADR keyword 
parameter for the format of the ID.) If the keyword parameter KEYLEN 
has been specified, the key and data portions of the record are read; 
otherwise, only the data portion is read. If KEYLEN is specified, it 
must be equal to the length of the key that is on the disc. The record 
number of the ID cannot be 0. 


POSITIONAL PARAMETER 3 


H — the direct access method processor checks the lockout table for the 
address in SEEKADR before issuing the I/O command. If no other 
job has made an entry for,the track, an entry is made in the table 
and the command is issued. See HOLD=YES parameter in 4.1.1. 


NOTE: To execute a READ macro instruction with the KEY positional parameter, 
the keyword parameter READKEY=YES must be specified in the DTFDA 
macro instruction. 


To execute a READ macro instruction with the ID positional parameter, 
the keyword parameter READID=YES must be specified in the DTFDA 
macro instruction. 
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To execute a READ macro instruction with the H positional parameter, 
~ the keyword parameter HOLD=YES must be specified in the DTFDA 
macro instruction. 


Example: 


LABEL & OPERATION 6 OPERAND 








4.1.2.3. WRITE Macro Instruction 


This imperative macro instruction causes a record to be written from main storage 
to the direct access storage device. There are two forms for the WRITE macro 
instruction in the direct access method. One form provides for a direct write into 
a defined area on the disc and is used to update existing records. The count field 
is never altered in this form of the write instruction and the rest of the track is 
not cleared. The other form provides for writing a record following a specified 
record, A format write (which writes a count field followed by either a data field 
or key and data fields) is involved and the rest of the track is cleared. To ensure 
that the data has been transferred, a WAITF macro instruction must be used. 


The main storage address from which the data is written is specified in the location 
defined by the keyword parameter IOA1. 


If the keyword parameter VERIFY is specified, all records written are check-read 
for bad parity. 


The format of the WRITE macro instruction for a write into a defined area on the 
disc is: 


LABEL B OPERATION 5 OPERAND 


filename KEY 
[name] 
(1) ID 





POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTFDA declarative macro instruction 
in the program. 


(1) — indicates that register 1 has been preloaded with the address of the 
declarative macro instruction. 


POSITIONAL PARAMETER 2 


KEY —initiates a search for the record with the specified key, followed by 
a write of the new record over the data portion of that record. The 
search is initiated at the address given at the location specified by 
the SEEKADR keyword parameter and is confined to either a track 
or a cylinder depending on whether the SRCHM keyword parameter 


Nee! is specified. 
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ID —a search is made on a matching identifier. (Refer to the SEEKADR 
keyword parameter for format of the identifier.) The key field may 
or may not be updated. If the keyword parameter KEYLEN is speci- 
fied, the key and data portions of the record are updated; otherwise, 
only the data portion is updated. The record number of the ID cannot 
be zero. 


NOTE: When either the KEY or the ID positional parameter is specified in the 
WRITE macro instruction, the count field on the direct access storage 
device controls the key (where provided) and the data transfer. If the 
new record is longer than the old, the new record is truncated; if it is 
shorter, it is padded with binary 0’s. 


If the keyword parameter KEYLEN is specified and a WRITE macro 
instruction with the ID positional parameter is issued, the key field must 

be updated or rewritten and its length must equal the key length in the 

count area of the record. If the KEYLEN keyword parameter is not specified, 
the key field of the record is skipped and only the data portion of the record 
is updated. 


The format of the WRITE macro instruction to write a record after a specified 


record is: 
LABEL B OPERATION 5 OPERAND 
filename AFTER 
[name] , ¢AFTER,EOF 
(1) RZERO 





POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTFDA declarative macro instruction 
in the program. 


(1) — indicates that register 1 has been preloaded with the address of the 
declarative macro instruction. 


POSITIONAL PARAMETER 2 


AFTER — a new record is written after an existing record. The new record 
(count, key (if present), and data) is written and the remainder of 
the track is cleared. The disc address given at the location defined 
by the SEEKADR keyword parameter is used to determine the track 
on which the new record is to be written. The capacity record (RO) 
is updated when the WRITE macro instruction has been successfully 
issued. This form is used to create a file, or to add records to an 
existing file. 


RZERO — is used to clear a track specified by the address given at the location 
defined by the SEEKADR keyword parameter and to reset the capacity 
record (RO) to reflect the fact that RO is the only record on the track. 
This form is used to delete records from a given track within a file, 
or to reset a track to its initial conditions. Also, this form may not 
be issued if RELATIVE=R has been specified. 
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POSITIONAL PARAMETER 3 









































Ne 
EOF — is used to write an end-of-file record (data length of 0) after the last 
existing record on a track. The end-of-file record will contain a key, 
if KEYLEN has been specified. The user should supply a unique key 
to avoid any possible duplication. The capacity record (RO) is updated 
to include the end-of-file record. Positional parameter 2 must be speci- 
fied as AFTER. 

NOTE: When either of the AFTER or AFTER,EOF positional parameters are 
specified, the record is written only if there is sufficient space on the 
track. When the record will not fit on the requested track, the ‘‘no room 
found’’ bit of ERRBYTE is set. This should be checked every time a 
WRITE macro instruction, with the AFTER positional parameter speci- 
fied, is issued. 

Examples: 

LABEL tf OPERATION 6 OPERAND 
10 16 
WIR I TEP [UPD A, TIE,, RZ, ERO pba i be pp Pe i 
WIRI TE] INEWF ILE, AFITER | eo 
4.1.2.3.1. Capacity Record 
Seeds Record 0 on each track contains the identifier of the last record written on the 
track and the number of bytes still available. The capacity record (see Figure 
4—2) is used with the WRITE macro instruction when the AFTER or RZERO 
positional parameter is specified to ensure that space is available for a record. 
When using the direct access method, there must be a capacity record on every 
track within the file which conforms to the following specifications, 
COUNT AREA 
0 1 2 3 4 5 6 7 
KEY DATA 
IDENTIFIER LENGTH LENGTH 
DATA AREA 
0 1 2 3 4 5 6 7 
NUMBER OF 
IDENTIFIER OF LAST RECORD UNUSED BYTES RESERVED 
Figure 4—2. Capacity Record — Record 0 
w Count Area 
— Identifier is expressed in the form CCHHO. 
Noe — Key length is 0. 


— Data length is 8. —_— 
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w Data Area 


7 
— Identifier of the last record is expressed in the form CCHHR. 


— Number of unused bytes is the dynamic count of the bytes available on 
this track. The maximum is 3625 bytes. 


— The last byte is reserved for system use. 


4.1.2.4. WAITF Macro Instruction 


4.1.2.5. 


This macro instruction is used to ensure that a command initiated by a preceding 
READ or WRITE macro instruction has been completed and that all the data has 
been transferred to the area specified in the DT FDA declarative macro instruction. 
When completed, the status code field (ERRBYTE) as defined in the DTFDA macro 
instruction contains the error or status information pertaining to the I/O request 
(see Table 4-1). It is the user’s responsibility to check these bits. The WAITF 
macro instruction must be issued after a READ or WRITE macro instruction and 
before issuing another READ, WRITE, or CNTRL macro instruction. 


The format of the WAITF macro instruction is: 


LABEL 6B OPERATION 5 OPERAND 


filename 
[name] 


(1) 





POSITIONAL PARAMETER 1 ad 


filename — is the label of the corresponding DTFDA declarative macro instruction 
in the program. 


(1) — indicates that register 1 has been preloaded with the address of the 
declarative macro instruction. 


CNTRL Macro Instruction 


This macro instruction enables the user program to control overlap between seek 
activity and read/write activity on nonshared units. The effect is to initiate head 
movement to the designated position on the direct access storage device. Since 
control is returned to the user when the order is initiated (instead of completed), 
the user can then process asynchronously with the head movement. Any previous 
READ or WRITE macro instruction must be accompanied by a WAITF macro instruc- 
tion before a CNTRL macro instruction is executed. 


A WAITF macro instruction should not be executed following a CNTRL macro 
instruction. If a CNTRL macro instruction is issued for a shared unit, the command 
associated with the macro instruction is ignored. 


The format of the CNTRL macro instruction is: 


LABEL 6B OPERATION 65 OPERAND 
filename 
, SEEK ool 
(1) 
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POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTFDA declarative macro instruction 
in the program. 


(1) — indicates that register 1 has been preloaded with the address of the 
declarative macro instruction. 
POSITIONAL PARAMETER 2 


SEEK  -— this parameter must be specified. The seek operation is initiated by 
logical IOCS at the address given at the location defined by the 
SEEKADR keyword parameter. 


LBRET Macro Instruction 

The LBRET macro instruction is used for direct access method files in connection 
with the OPEN macro instruction (see 4.1.2.1). The LBRET macro instruction 
enables the user to create or check user standard header labels and to process 


extent information. 


The format of the LBRET macro instruction is: 






LABEL 6 OPERATION 6 OPERAND 


1 
{name] 
2 
POSITIONAL PARAMETER 1 
1 — indicates that no more labels or extents are to be processed. 
2 — indicates that there are more labels or extents to be processed. 


The LBRET macro instruction may be used with direct access storage devices 
for any or all of the following purposes: 


Processing User Header Labels 


Logical IOCS delivers these labels one at a time to the user until either all 
existing user standard header labels have been read or until the user specifies 
there are no more labels. 


The user label routine may process the header label delivered by logical IOCS 
and then return control to logical IOCS by specifying either 1 or 2 for the 
positional parameter. 


Creating User Standard Header Labels 


The user delivers header labels to logical IOCS one at a time (up to a maximum 
of eight labels). The number 1 is specified in the positional parameter when the 
user wishes to stop writing labels before the maximum number (eight) has been 
written. When control is returned, logical IOCS writes a file mark, and continues 
with logical IOCS processing. 
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The number 2 is specified in the positional parameter if the user wishes to have 





control returned after logical IOCS has written the label. Control is returned to = 
the user until eight labels have been written. When control is returned to logical 
IOCS with the eighth label, logical IOCS writes this label, writes a file mark, and 
continues with logical IOCS processing. 
ge Extent Checking 
Logical IOCS delivers extent information to the user, one extent at a time. The 
number 1 is specified in the positional parameter when the user has completed 
processing all the information in the extent. 
The number 2 is specified in the positional parameter if the user wishes to 
receive another extent. If there are no more extents, logical IOCS does not 
return control to the user even though the number 2 was specified in the posi- 
tional parameter. 
The user should design the coding that handles his header labels or extent 
information as island code, which permits the use of a synchronous or an 
asynchronous environment during OPEN transient processing. Control is 
given to the user at his specified address with a processing time limit of 
500 milliseconds to execute a LBRET return. (If this time limit is exceeded, 
fatal error procedures will be followed.) 
Following is an example of user extent processing, illustrating how user island 
| code can function. 
ee” 
LABEL & OPERATION & OPERAND 
) 10 16 
1. [XT IN, TXT | |ejA,L,R | 2, 0 
7 eee wen en cu oe ne ere Onan mann meee 
So ee ee ben ere 
i rere reel i ere mura 
6 [eae ae VISTA eT 
a Merete Vinee @ Cesceven 
ets i i iy | ftyeRe,r| |2 
9. [EXT ,1 Hoc, | [ACEX,TLAR,E,A,) 
TLE X,TARIEA, | fois, . | [16.e,L, 114 
n.[EX.T2 Toes | Ivo 
mf. ...1..1 foro, | [2 
1. Load cover register 
2. R2 is cover register 
3. Point to current extent store area 
4. Store current extent 
5. Add 14 to address in register 3 ey: 
6. Replace address in EXT constant 
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7. Count number of extents 

8. Return control to OPEN for next extent 

9. Address of extent store area 
10, Extent store area; assumes a maximum of 16 extents 
11, Counter for number of extents 
12. Drop cover register 


4.1.2.7. RELEX Macro Instruction 


4.1.2.8. 


The RELEX macro instruction is used to remove entries from the lockout table. 


The format of the RELEX macro instruction is: 





LABEL | BOPERATION 5 | OPERAND 





filename 
{ (1) \ [,ALL] 


POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTFDA declarative macro instruc- 
tion in the program. 


(1) — indicates that register 1 has been preloaded with the address of the 
«+ declarative macro instruction. 


POSITIONAL PARAMETER 2 


ALL — indicates that all entries of the job are to be released. If this para- 
meter is omitted, only the entry of the address in SEEKADR is re- 
leased. If no entry for the track is found in the lockout table for that 
job, the TRACK NOT LOCKED bit of ERRBYTE is set. 


CLOSE Macro Instruction 
The CLOSE macro instruction is used to terminate processing for the file specified 


by filename. Once a file is closed it may not be accessed again except by issuing 
another OPEN macro instruction for that file. 


The format for the CLOSE macro instruction is: 






+ OPERATION & | OPERAND 





filename 
filename-1,filename-2,...,filename-n 


(1) 


{name] 


POSITIONAL PARAMETER 1 


filename — is the label(s) of the corresponding DF TDA declarative macro 
instruction(s) in the program. 


(1) — indicates that register 1 has been preloaded with the address of the 
declarative macro instruction. 
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Example: 
—/ 
LABEL ts OPERATION 6 OPERAND 6 
1 10 16 
Peta | feeosiel tai, | bea pba ee Pe a 
4.1.3. Instruction Usage 
A file that uses the direct access method may be processed in either a sequential 
or a random manner. Following are examples which illustrate usage of the impera- 
tive macro instructions for both types of processing. 
m Create a sequential file 
WRITE filename, RZERO Used to initialize the capacity record for a track 
(RELATIVE # R) within the file (if this has not been done with a 
utility program). 
WRITE filename,AFTER Used to put a record on a track in the file. 
(Check ‘‘no-room-found’’ bit of ERRBYTE to 
determine if a rewrite to the next track is neces- 
sary.) 
WRITE filename, AFTER,EOF Used to write an end-of-file record at the end of 
the file. 
w Read a sequential or random file NS 
READ filename,ID ae eee rene 
READ filename,KEY sed to access any record within the file. 
m Update a sequential or random file 
WRITE filename,ID Used to update already existing records within 
WRITE filename, KEY the file. 
m Add records to an existing file on a currently unused track. 
WRITE filename,RZERO (RELATIVE # R) 
WRITE filename,AFTER 
m Delete records on a given track within the file. 
WRITE filename, RZERO (RELATIVE Z R) 
4.1.4. Data Management Error Analysis Routine (DMEAR) 


UNIVAC 9400 









The Data Management Error Analysis Routine provides information for fatal 
hardware or logical errors that have taken place in opening, processing, or 
closing a Data Management file (3.4). 
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4.2. INDEXED SEQUENTIAL ACCESS METHOD 


The Indexed Sequential Access Method (ISAM) allows the use of a UNIVAC Direct 
Access Storage (Disc) Subsystem to process a file in either a random or a sequen- 
tial manner. Four distinct file processing functions are provided: 


m Loading (creating, extending, or reloading) a file, which consists of writing pre- 
sorted input records and their key fields onto the direct access storage device, 
while creating and writing out a set of indexes; 


w Retrieving and updating records sequentially (in ascending order by key); 
w Retrieving and updating records randomly (by key); 
w Adding new records to an existing ISAM file. 


Once a file has been created, any combination of the last three functions can be 
performed in a program. 


An ISAM file contains three types of disc areas: prime data areas, an index area, 
and overflow areas. The bulk of the file is contained in the prime data areas of 
which there may be a maximum of eight; one on each volume of the file. Within a 
prime data area, the records are arranged in ascending order by key. They are always 
fixed in length, but for a given file may be in either an unblocked (one logical 

record per physical record) or blocked (several logical records per physical record) 
format. 


When a new record is inserted into a prime data area track, all records on the track 
with higher keys are shifted toward the end of the track. The last record, if dis- 

Ne placed from the track, is written into an overflow area. This may be an area associated 
with the cylinder containing reserved tracks (a cylinder overflow area), or it may be 
an area associated with the entire file (the independent overflow area). In either case, 
the overflow record is linked to the track from which it was displaced. 


The basic control structure of an ISAM file is provided by a hierarchy of indexes. 
The first or lowest level index is the track (head) index, one of which appears at 
the beginning of each prime data cylinder. For each prime data track in the cylinder, 
there are two track index entries. The first entry contains the highest key on the 
track (that is, the key of the last record) and the disc address (cchh) of the 

track. The second entry of the pair contains the highest overflow record key associ- 
ated with the track, and the disc address of the first overflow record (cchhr) —_— 
associated with the track. The second and next higher level of index is the 

cylinder index which resides in the separate index area on the disc. For each prime 

data cylinder, there is a cylinder index entry which contains the highest key associ- 

ated with the cylinder, and the disc address of the track index for the cylinder~ 

(that is, the address of the beginning of the cylinder). The third and highest level 

of index is the optional master index. If a master index exists for a file, it resides 

in the separate index area immediately preceding the cylinder index. Each entry in 

the master index contains the highest key on a cylinder index track and thedisc 

address of that track. 
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To locate a logical record by its key, the proper track is located by searching down 

through the indexes. A search of the master index, if one exists for the file, yields uf 
a track address in the cylinder index. A search of the cylinder index track, or of 

the whole cylinder index if a master index does not exist, yields the address of the 

desired prime data cylinder. A search of the track index then yields the address of 

the prime data track, or overflow area containing the desired recotd. In the former 

case, the track is searched to locate the record; in the latter, the chain of over- 

flow records linked to the prime data track is searched. Figure 4—3 is a flow dia- 

gram of the ISAM index search method. 


aa ae as 7 

| MASTER [ PRIME 
—»} INDEX | DATA 

| (optional) = | CYLINDER 

heel 






Fh ee ae ed 











TRACK 






CYLINDER (HEAD) 
INDEX INDEX 
(two entries) 





OVERFLOW 
AREA 





Figure 4—3. ISAM Index Search Method, Flow Diagram 


4.2.1. Declarative Macro Instruction 


A file that is to be processed by the indexed sequential access method must be 
defined in the problem program by the DTFIS declarative macro instruction. The 
symbolic name of the file (filename) can have a maximum of seven characters 
and must begin with an alphabetic character. The filename is also used in the 
related imperative macro instructions to identify the file. 
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Following is a listing, in alphabetic order, of the required and optional keyword 
parameters which may appear in the operand field of the DTFIS macro instruction. 
A description of each keyword parameter follows the listing. Figure 4—4 illus- 
trates the dependency relationship among the parameters; that is, when certain 
parameters are specified, the programmer must choose two or more related param- 
eters which, in turn, may require further choices, depending upon the file 
processing function being performed. A summary of the keyword parameters is 
given in Table 4—6 at the end of the description. 


6B OPERATION % OPERAND 


filename 
IOAREAR=symbol [ ,LOAREAS=symbol! ] 


{toareat=syate [ ,IOAREAR=symbol ] 1,10AREAS=symbo! ] 
IOAREAS=symbol 


ADD 
ADDRTR 
IOROUT= < LOAD 
RELOAD 
RETRVE 
KEYLEN=n 
FIXBLK 
rere [Freon 
RCSZ=n 
_ {(NOWRITE [,DISPLAY]) 
[ctose. eee 
let eee 
PCYLOFLe=nn 
8411 
DEVICE=< g414 
8424 


LEOFA=symbol] 
[ERROR=symbol] 
{INDAREA=symbol ] 
[INDSIZE=n ] 
[IORG=(r) ] 
[IOSIZE=n } 
[KEY ARG=symbol] 
[KEYLOC=n] 
{MSTIND=YES] 
[NRECDS=n } 
RANDOM 
[rvee- RANSEQ | 
SEQNTL 
IVERIFY=YES] 
WORKS=YES [,WORKL=symbol ][,WORKR=symbol ] 
| }WoRK.=symba [,WORK R=symbol ] | 
WORKR=symbol 





NOTE: Assembler rules concerning commas and continuation of parameters in 
operand field apply when writing this macro instruction; see 1.2. 
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LOAD/RELOAD ADDRTR RETRVE 


IOAREAL=symbol,WORKL=symbol TYPE= 





RANDOM SEQNTL 


IOAREAR=symbol,KEYARG=symbol IOAREAS=symbol,| KEYARG=symbol| 
ee te Mecca 
IORG=(r) IORG=(r) 


RCFN= INDAREA=symbol 





INDSIZE=n 


FIXBLK 





FIXUNB 


NRECDS=n,KEYLOC=n 





Figure 4~4. DTFIS Related Dependent Parameters 
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a Close Time 


The optional keyword parameter CLOSE specifies two unrelated actions. When 
IOROUT=RETRVE, hardware file protect can be applied if the following keyword 
parameter is specified: 


CLOSE=(NOWRITE) 


The format 2 label will not be rewritten, and the fields labeled DL$TD2 and 
DL$NF2 will not be updated (see 2.3.3). 


To display at the console the fields addressable by the filename linked with 
prescribed letter suffix, the following keyword parameter is specified: 


CLOSE=(DISPLAY) 


See E.7 for the format of the display. IOROUT determines which concatenated 
fileriame fields are available at close time: 
LOAD 


a) 1oRouT: |LOAP, 


filenameP 
filenameS 


(2) IOROUT=RETRVE 
filenameR 
filenameS 
filenameT 


(3) IOROUT=ADD 


filenameA filenameP 
filenamel filenameS 
filenameO 


(4) IOROUT=ADDRTR 


filenameA filenameP 
filenamel filenameR 
filenameO filenameS 
filenameT 


Therefore, when IOROUT=RETRVE it is possible to specify the following: 


CLOSE=(NOWRITE,DISPLAY) 
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gw Cylinder Overflow 


The following optional keyword parameter specifies the number of tracks in each 
prime data cylinder that is reserved for cylinder overflow for a file being loaded: 


CYLOFL=n 


where n is the number of tracks (maximum of eight for UNIVAC 8411 disc or 
18 for UNIVAC 8414 disc). 


The following keyword parameter specifies the number of tracks reserved for 
cylinder overflow as a percentage of the number of tracks per cylinder: 


PCYLOFL=nn 


where nn is a percentage declaration less than 99 and greater than or equal to 0. 


If neither CYLOFL nor PCYLOFL is specified, no tracks are reserved for cylinder 
overflow. 


Device Type 


The following optional keyword parameter defines the type of device which contains 
the data file: 


8411 


DEVICE=< 8414 
8424 


where 8411 denotes the UNIVAC 8411 Disc Subsystem, 8414 denotes the Ree 
UNIVAC 8414 Disc Subsystem, or 8424 denotes the UNIVAC 8424 Disc Subsystem. 


To process the file starting with the OPEN transient routines, use the device 
characteristics obtained from the Physical Unit Block (PUB) device type of the 
first volume. All other volumes of the file must be consistent with the first. 


End of File 


When an end-of-file condition occurs in connection with sequential retrieval 
operations, the user may have control transferred to a special end-of-file routine 
by specifying the following optional keyword parameter 


EOF A=symbol 


where symbol is the address of the user’s special end-of-file routine. 

When control is transferred to the user’s rou“ine, register 14 contains the normal 
return address to the instruction following the imperative macro instruction 
during which the end-of-file condition was detected. Registers 2 through 12 are 
restored and register 1 contains the DTFIS macro instruction address. 


If this keyword is not specified, control is returned to the normal return address 
in the user’s program with an indication of the end-of-file condition in filenameC. 


Major File Error 


When a fatal hardware or detectable logical error occurs on a file, the user may — 
have control transferred to a special error handling routine by specifying the 
following keyword parameter: 


ERROR=symbol 
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where symbol (label) is the address of the error handling routine. When logical 
IOCS transfers control to the routine, registers 1 through 12 are restored. If 
control is passed to the ERROR address from a processing macro instruction 
(such as GET and WRITE NEWKEY), the address of the instruction following 
the macro call is found in register 14. Register 14 is restored to the value in the 
register preceding the transient call (OPEN and CLOSE). Register 0 contains 
the following information concerning the reasons for the error. 


— Bytes 0 and 1 reflect the first and second hardware sense bytes if the error 
is a hardware error; otherwise, these bytes contain binary 0’s. 


— Byte 2 contains a one-character EBCDIC value indicating in what section of 
processing the error occurred, where 4 = transients and 1 = processing. 


— Byte 3 contains a one-character EBCDIC value indicating the reason for the 
error; refer to Appendix E. 


Transient routines also cause an informational typeout, inserting bytes 2 and 3 as 
xx in standard Data Management message format (DMxx). If this keyword parameter 
is not specified, abort procedures are executed when a major file error occurs; 

the console typeout still appears. 


Refer to Appendix F for further information regarding error conditions which 
are peculiar to ISAM. 


m Cylinder Index in Main Storage 


This optional group of keyword parameters specifies that the cylinder index, 
or some section of it, is to reside in main storage, thus decreasing the 
number of disc accesses required to process the file when inserting records 
or doing random processing. The minimum number of bytes required to. hold 
n cylinder index entries in main storage is: (key length+6) times (n+2). 
For example, given a key length of 28, it would require 408 bytes to hold 

10 cylinder index entries in main storage. If the entire cylinder index is 

to reside in main storage, the number of bytes required is: (key length+ 6) 
times (the number of prime data cylinders + 3). If there were 16 prime data 
cylinders, it would take 646 (that is, 34 times 19) bytes. 


The symbolic name of the main storage area assigned to hold the cylinder 
index is specified as 


INDAREA=symbol 
The number of bytes (n) available for the cylinder index is specified as 
INDSIZE=n 


If n is large enough so that the entire cylinder index can be held in main 
storage, the file can be processed in any sequence without loss of efficiency. 
If n is not large enough, the file should be referenced in key-order sequence to 
take full advantage of the resident cylinder index section. The number of bytes 
required to hold the entire cylinder index in main storage is available to the 
user program, each time that the file is closed, in a two-byte field addressed 
by the concatenated label filenameS (refer to 4.2.2). 
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mw Input/Output Areas 


Depending on the IOROUT and TYPE keyword parameters, one, two, or three is 
input/output area keyword parameters must be specified. Each I/O keyword 
parameter is specified as 


IOAREAx=symbol 
where x is: 
L for loading or adding to the file. 
R for retrieving and updating in a random order. 
S for retrieving and updating in sequential order. 


Symbol is the address of the I/O area. Table 4—5 indicates which I/O areas 
must be specified for the various combinations of parameters, and the 
minimum size requirements for each. 


Note that the size of the I/O area must be at least 96 bytes, because the OPEN 
transient routines use this area for reading the 96-byte format 2 label data. 


| voaReA AREA WORK AREA 
!{OROUT TYPE RCFM KEYWORD] AREA SIZE ae KEYWORD] AREA SIZE| NOTES 


Ged e 
LOAD or = 
0 FIXBLK | |OAREAL= Ged WORKL= RESZ a 
RELOAD symbol — 
8 lee | symbol KEYLENt 
} Foxune. | lee | RCSZ 


StKEYLEN+ 
8tKEYLEN+ KEYLEN+ 
ae 
SEQNTL loAREAS=| ROSZ xNRECDS Not if eee RCSZ | resz | 12 | 
RETRVE or lORG 
ADDRTR RCSZ+10 RCSZ 


RANDOM FIXBLK IOAREAR=|RCSZxNRECDS 
or symbol 
RANSEQ FIXUNB RCS2+10 


ADDRTR 





NOTES: (1) I/O area size must be equal to the largest of: RCSZ+10, RCSZxNRECDS, or 96. 


(2) The individual GET and PUT imperative macro instructions specify the work 
areas to be used. 


(3) I/O area size must be equal to the largest of: 8BKKEYLENtRCSZxNRCEDS, 
8tKE YLENtRCSZ410, or 96. 


Table 4~5. 1/0 and Work Area Requirements for ISAM Files 


aaa 
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- @ Current Record Pointer 


NW When records are referenced in the I/O areas rather than in the work areas, 
the general register to be used to store the address of the I/O area must be 
specified by the keyword parameter 


IORG=(r) 
where (r) is the number of the general register (2 through 12). 


w File Processing Function 


The processing to be performed on the file must be specified by the keyword 


parameter 
LOAD 
\ RELOAD 
ADD 
IOROUT= 
y RETRVE 
| ADDRTR 


where: LOAD indicates that either a new file is created or an old file is extended; 
RELOAD indicates that an existing file is being re-created in the same disc space 
(the file identifier is the same); ADD indicates that new records are inserted into 

a file; RETRVE indicates that records are retrieved (and/or updated) either randomly 
or sequentially; and ADDRTR indicates that both the ADD and the RETRVE functions 
are performed. 


m Expanded I/O Area 


If increased throughput is desired when insertions are to be performed, it may be 
achieved by allocating more than the minimum number of bytes to the IOAREAL 
area. The total number of bytes is specified by the optional keyword parameter 


IOSIZE=n 


where n is the total number of bytes available in the IOAREAL area, It must 

specify enough space to contain a prime data track in IOAREA. That is, it must 

be large enough to contain MXDB*(BDB+8) bytes (see H.3.2). The maximum 

number of bytes for the UNIVAC 8411 disc is 3613, and the maximum number of 

bytes for the UNIVAC 8414 and 8424 discs is 7257. <«< 


m Retrieval Search Argument 


When retrieval functions based on record key (random retrieval or sequential 
retrieval starting with a specific key or key group) are to be performed, the 
address (symbol) in the problem program of a field which contains the key 
to be used as a search argument must be specified as 


KEYARG=symbol 


a Key Length 


All keys in an ISAM file are the same length. The key length, in bytes, 
for the file must be specified as 


KEYLEN=n 
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where n is greater than 2 and less than 256. Note, as illustrated in Figure 4—5, 
the key length is a part of record size for blocked records, which have embedded SY 
keys, but is an addition to record size for unblocked records, which have 

separated keys. 


@ Key Location 


If blocked records are to be processed, the location of the key field within 
all records of the file must be the same, and is specified as 


KEYLOC=n 


where n is the location, counting from 1, within each record of the high 
order byte of the key field. For example, if the key field is in bytes 17 
through 24 of each record, KEYLOC=17 is specified. 


m Master Index 


If a master index is to be constructed for a file being loaded, the keyword 
parameter is specified as 


MSTIND=YES 


The master index immediately precedes and is in the same disc extent as 
the cylinder index. 


A. Blocked Record Format 


LOGICAL RECORD 


KEYLOC 


——_—____— R052 





B. Unblocked Record Format 


LOGICAL RECORD 





Figure 4-5. Prime Data Record Formats for [SAM Files 


m Blocking Factor 


If blocked records are to be processed, the blocking factor (that is, the number 
of logical records per physical block) must be specified by the keyword 
parameter 


NRECDS=n 


where n is the blocking factor and is greater than 0 and less than 256. 
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A. Overflow Record Format, Blocked Records 


2 


COUNT 
AREA KEY AREA DATA AREA 


PHYSICAL [* LOGICAL RECORD 
LINK 


B. Overflow Record Format, Unblocked Records 


KEY AREA DATA AREA 


SEQUENCE LOGICAL RECORD 
LINK 


Figure 4-6. Overflow Record Formats for [SAM Files 
















PHYSICAL 
RECORD 





ee ea 


If this keyword parameter is omitted, a blocking factor of 1 will be assumed. 
This parameter is ignored if unblocked records are to be processed. 


@ Record Format 


Records in an ISAM file are fixed in length and their format must be defined as 
either blocked or unblocked. The required keyword parameter for this is speci- 
fied as 


RCFM=FIXUNB (for unblocked records) 
or 
RCFM=FIXBLK (for blocked records) 


Figure 4—5 illustrates the differences between the two formats: blocked 
records have embedded keys; unblocked records have separate keys. Figure 
4—6 shows the differences between the two overflow record formats. 
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m Record Size 


a 
Records in an ISAM file are fixed in length and must be specified by the 
keyword parameter 
RCSZ=n 
where n is the number of bytes in each record. As shown in Figure 4—5, 
record size includes the key length for blocked records, but not for un- 
blocked records. 
a File Processing Type 
For ISAM files on which retrieval functions are to Uc nerformed (IOROUT 
specified as RETRVE or ADDRTR), the type of prov=ssing, random or se- 
quential, must be specified by the TYPE keyword parameter as follows: 
— TYPE=RANDOM 
if random processing is to be performed, 
— TYPE=SEQNTL 
if sequential processing is to be performed, or 
— TYPE=RANSEQ 
if both random and sequential processing are to be performed. 
g@ Verification Requirements SY 


The following optional keyword parameter requests that a parity check be made 
of data records after they have been written on the device: 


VERIFY=YES 


Data Management reads back one byte of data and checks for a successful 
completion to verify that the record transferred was written correctly. The 
hardware cyclic check feature establishes if the transfer was completed 
successfully. Verification of records necessarily increases the execution 
time for the commands associated with the WRITE macro instruction. 


m Work Area 


Depending on the IOROUT and TYPE keyword parameters, one, two, or three 
work area keyword parameters must be supplied. These are specified ‘as 


— WORKL=symbol, 


if the file is to be loaded, reloaded, or added to, and where symbol 
is the address of the work area; 


— WORKR=symbol, 


if records are to be retrieved (and updated) randomly, and 
where: symbol is the address of the work area; or, 


aw 
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~ 
— WORKS=YES, 
NN . . . 
if records are to be retrieved (and updated) sequentially, and 
where each GET and PUT imperative macro instruction will 
provide the address of a work area. 
Table 4—5 indicates when each keyword must be specified 
and what the minimum work area size requirements are. 
Following is a summary (Table 4—6) of all the keyword para- 
meters for the DTFIS declarative macro instruction. 
FILE PROCESSING FUNCTION 
KEYWORD SPECIFICATION LOAD ADD RAN SEQ REMARKS 
RELOAD RTR RTR 
(NOWRITE) x Xx Format 2 label 
is not rewritten; 
DL$TD2 and 
DL$NF2 are 
not updated. 
(DISPLAY ) x x Xx Causes console 
display of fields 
addressable by 
the filename 
linked with the 
proper letter 
suffix. 
CYLOFL n=number of x Number of tracks 
tracks per prime cylinder 
for cylinder over- 
flow area 
DEVICE 8411, 8414, or 8424 ieee — 
ee EOFA symbolic x Address of user's 
label end-of-file 
routine 
ERROR symbolic x Address of user’s 
label unrecoverable 
error routine 
INDAREA symbolic Address of cylin- 
label der index resi- 
dence area 
INDSIZE n=number of Size of cylinder 
bytes index residence 
IOAREAL symbotic 
label 
IOAREAR symbolic 
tabel 
IOAREAS symbolic 1/0 area for se- 
area quential process- 
IORG (r)=general Pointer register . 
register when records are 
to be processed 
in 1/0 area 
IOROUT ADD Insertions are to 
be performed 
ADDRTR Insertions and 
tetrievals are to 
be performed 
LOAD File is to be 
RELOAD created or extended 
RETRVE Retrievals are to 
be performed 
Need Table 4—6. Summary of Keyword Parameters for the DTFIS Macro Instruction 


(Part 1 of 2) 
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FILE ae aes FUNCTION aed 
KEYWORD SPECIFICATION LOAD RAN SEQ EMARKS 
RELOAD RTR RTR 
IOSIZE n=number of bytes Size of 1/0 area if 
in !/O area greater than minimum 
KEYARG symbolic Address of key~ 
label search argument 
KEYLEN n=number of bytes Smee R ES Key length 
KEYLOC n=position of key Xx X Location of key in 
blocked record 
MSTIND YES xX Master index is 
used for file 
PCYLOFL nn=a percentage Number of tracks 
declaration less reserved for 
than 99 and cylinder over- 
greater than or flow as a pet- 
equal to 0. centage of the 
number of tracks 
per cylinder. 
RCSZ n=number of bytes Logical record 
size . : 
eer 
TYPE RANDOM Random retrievals 
are to be performed 
Random and se- 
quential retrievals 
are to be performed 
SEQNTL Sequential retrievals 
are to be performed 
VERIFY YES All write operations 
are check-read 
YES Records to be pro- 
cessed in work areas 
specified by GET and 
PUT macro instruc- 
tions 
WORKL symbolic label User supplies records 
in work area 
WORKR symbolic label Records to be pro- 
cessed in work area 
LEGEND: 
RAN RTR - Random retrieval 
SEQ RTR - Sequential retrieval 
R - Required 
X - Optional : 
7 


Y - One option required 


Table 4-6. Summary of Keyword Parameters for the DTFIS Macro Instruction 
(Part 2 of 2) 
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4.2.2. Filename Field Addressing 


ee 

When linked with prescribed suffix letters, the symbolic name of the file (file- 

name) is available to the user program for addressing certain fields within the 

file table generated by the DTFIS declarative macro instruction. For example, 

linking filename with the suffix letter C (filenameC) addresses the error and 

status indicators in the file table. Table 4—7 summarizes all the fields that 

canbe addressed, their byte size, and whether or not they can be saved by the 

program. Further explanations on the use of these fields are given in the descrip- 

tions of the ISAM imperative macro instructions and in Appendix F. 

LENGTH 
SUFFIX IN FILE PROCESSING FUNCTION 
LETTER FIELD DESCRIPTION TYPE} BYTES “o- LOAD | ADD ge RTR “6 RTR 
RELOAD 
Number of cylinders which 
have full cylinder overflow 
areas 
Error and status indicators 
Disc address from which 
record was retrieved 
(mbbechhr) ant 
Disc address to which record 
was/will be transferred 
(mbbechhr) —— 
Number of unfilled tracks in 
Ne the independent overflow area 


Total number of prime data 
records 


Number of overflow records 
retrieved which were not 
first in chain 


Number of bytes required to 
hold entire cylinder index in 
main storage 


Number of records tagged for 
deletion by the user program 


NOTES: (4) The fields indicated as being saved are preserved in the disc 
format 2 label when the file is closed, and are initialized from 
the format 2 label when the file is reopened. 


@ RAN RTR - Random retrieval 

(3) SEQ RTR - Sequential retrieval 

()__-H - Halfword, F - Fullword, X - Hexadecimal 
© Available only after CLOSE. 





Total number of overflow 
records 


Table 4-7. DTFIS Fields Addressable by User Programs 
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Imperative Macro Instructions 


The following paragraphs describe in detail the imperative macro instructions 
available for processing ISAM files. Five groups of macro instructions are 
described in accordance with the file processing functions involved. These are: 


g Basic macro instructions: OPEN and CLOSE. 


a File loading and file extending macro instructions: SETFL, WRITE NEWKEY 
(see 4.2.3.2.2), and ENDFL. 


mw Record insertion macro instructions: WRITE NEWKEY (see 4.2.3.3.1) and 
WAITF. 


m Random processing macro instructions: READ KEY, WRITE KEY, and WAITF. 
m Sequential processing macro instructions: SETL, GET, PUT, and ESETL. 


In addition to using general registers 0 and 1, all the imperative macro instruc- 
tions assume the presence of a 72-byte user save area, the address of which 
must be stored in register 13. The contents of general registers 2 through 12 
are always placed in the save area when control is transferred from the user 
program to the file processor, and are restored when control reverts to the user 
program. 


A responsibility of the user program is to check, after each imperative macro instruc- 
tion (except OPEN and CLOSE), the two-byte field in the file table labeled filenameC 
for error or exceptional conditions. (Refer to Appendix F.) 


Basic Macro Instructions 


The basic macro instructions, OPEN and CLOSE, are used in all file processing 
operations. The OPEN macro instruction initializes the file processing while 
the CLOSE instruction terminates the file processing. The term ‘‘new file’’ refers 


to a file that has never been successfully closed and which therefore has a null 
format 2 label. 


1. OPEN Macro Instruction 


This instruction must be used to initialize the file before any other impera- 

tive macro instructions can be performed. It calls a transient routine which 
performs required initialization operations, such as standard label processing 

and validation of extent information. Depending upon whether or not it ts a 

new file, disc format 1 and disc format 2 labels are either created or checked. Al! 


volumes of the file must be available for use at OPEN time. 
For each volume, the OPEN transient routine executes the following steps: 
— Checks the volume 1 (VOL1) label; 


— Checks or completes the disc format 1 label; 


— Saves and validates file-descriptive information, as specified in the 
format 1 label. SA 
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For the first volume of the file, the OPEN transient routine saves and 











Ue 
validates file-descriptive information, as specified in the format 2 label. 
The format of the OPEN macro instruction is: 
Bb OPERATION 6 OPERAND 
filename 
[name] OPEN filename-1 ,filename-2,...,filename-n 
(1) 
POSITIONAL PARAMETER 1 
filename — is the label(s) of the corresponding DTFIS declarative macro in- 
struction(s) in the program. 
(1) — indicates that register 1 has been preloaded with the address of 
the DTFIS macro instruction. 
Example: 
LABEL tb OPERATION 6 OPERAND 
1 10 16 
eeweee aneeeee Gugeewn sehen nam 
pont eae Sulceomenmancees 
hes eee tach hotel Reeee @ iy mel ose Gn fe at ee ae ene Di i 
Nee 


4.2.3.1.2. CLOSE Macro Instruction 


This instruction must be used to terminate processing of the file. The CLOSE 
macro instruction calls on a transient routine which performs required termina- 
tion operations, such as updating the format 2 label. Once closed, no other 
macro instructions can be executed for the file until it is reopened by the 
OPEN macro instruction. 


The format of the CLOSE macro instruction is: 













OPERAND 


{ oe | 


LABEL b OPERATION 6 









POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTFIS declarative macro in- 
struction in the program. 


(1) — indicates that register 1 has been preloaded with the address 
of the DTFIS macro instruction. 
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Example: 
















LABEL 6 OPERATIONS OPERAND 


10 








pea ee ee eg ee a ee 














SR a DO OG VO 
poe ae ee, ec eo eS 
| Te ee 








If desired, the user program may now access filenameS in the DTFIS address- 
able file table to determine the number of bytes required to hold the entire 
cylinder index in main storage (refer to Table 4-7). 


4.2.3.2. File Loading, File Reloading, and File Extending Macro Instructions 


Whether a new ISAM file is to be loaded (created), or an existing one is to be 
extended by adding records at the end, the file processing functions are the 
same. Both functions are indicated in the DTFIS declarative macro instruction 
by equating the IOROUT keyword to LOAD. If the file is being reloaded (re- 
created) the IOROUT keyword is equated to RELOAD. Records for the file are 
supplied in a work area in either the blocked or unblocked format (see Figure 
4-5). The imperative macro instructions are the same in either case. But the 
two processing functions are differentiated by an indicator in the disc format 2 
label. Once a file has been loaded successfully and a CLOSE macro instruction 
has been executed for it, the indicator is set so that subsequent processing of eee 
the file with IOROUT=LOAD will extend, rather than create, the file. IOROUT= 
RELOAD will re-create the file in the same disc extents from the beginning of 
prime data. 


Three imperative macro instructions are used: SETFL initiates the processing 
sequence, WRITE NEWKEY adds a record to the file, and ENDFL terminates 
the processing sequence. After each WRITE NEWKEY instruction, filenameP 
(see 4.2.2) is available; filenameS is not available until after CLOSE. 


4.2.3.2.1. SETFL Macro Instruction 


The SETFL (set file load) macro instruction calls on a transient routine which 
sets up controls in the DTFIS declarative macro, and in the indexes on the 
direct access storage device, to prepare the file for loading (or extending). 
Specifically, the transient routine performs the following tasks: determines 
whether there is sufficient index space to support the prime data area; performs 
the division of the index extent between the master index and cylinder index 
tracks; establishes the size of the track index and the configuration of each 
prime data cylinder; and preformats the last track of the track index for each 
cylinder of the prime data area. 


The format of the SETFL macro instruction is: 









6 OPERATION 5 OPERAND 





{ oe 
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POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTFIS declarative macro 
instruction in the program. 


(1) — indicates that register 1 has been preloaded with the 
address of the DTFIS macro instruction. 


Example: 


LABEL 6 OPERATION & OPERAND 6 
16 


pra atop pa torr eto trip terri te 








pea da eb te Pt 
EMPiEMIST) 1p ti pe et Pt 





pore topper terre der apae be area terra ta 








4.2.3.2.2. WRITE NEWKEY Macro Instruction 


The WRITE NEWKEY instruction (that is, WRITE is the operation code 
and NEWKEY is positional parameter 2) causes a logical record to be 
written to a file being loaded or extended. Specifically, it causes a 
record to be transferred from the WORKL working storage area to the 

ad IOAREAL I/O area. Before issuing the WRITE NEWKEY macro in- 
struction, the problem program must have stored the logical record and 
its key in the WORKL area in either of the formats illustrated in 
Figure 4—5. The following actions are performed in response to this 
macro instruction: 


m The key in the work area is checked against the key of the last record 
transferred into the I/O area, and if it is not greater, either a dupli- 
cate key or a sequence check error has occurred. The appropriate 
indication is set in the filenameC field of the DT FIS addressable 
file table (Table 4—7). Control returns to the problem program at the 
instruction address immediately following the WRITE NEWKEY macro 
instruction. The record in error is not transferred to the I/O area, and 
normal processing may be resumed with another valid logical record. 

m The record and its key are transferred from the work area to the I/O 
area. 


mw If the record formatis blocked, the key of the record is also transferred 
to the key area of the I/O area. 


m When the I/O areais full, a physical record is written into the prime 
data area on the direct access storage device. A physical record con- 
sists of count, key, and data areas, as illustrated in Figure 4—7 for 

co both blocked and unblocked records. 













UP-7629 
Rev. 2 






UNIVAC 9400 


DATA MANAGEMENT SYSTEM a 





SECTION: PAGE: 


m Ifa physical record is written, a check is made for an end-of-track 
condition. If this condition exists, two track index entries (normal 
and overflow) are written. If the filled track was the last prime data 
track of the current cylinder, a cylinder index entry is written. If the 
file has a master index, and if the cylinder index entry filled the cur- 
rent cylinder index track, a master index entry is written. 


gm Following the WRITE NEWKEY macro instruction, the disc address 

(ID) of the physical record into which the logical record was written 

(or will be written if the I/O area is not yet full) is available in an 

eight-byte DTFIS addressable field labelled filenameH (see Table 4-7). 
— The ID is in the form mbbcchhr, as described for the SEEKADR 

keyword parameter of the DIFDA macro instruction (see 4.1.1 ). Also 

available is the four-byte count of the total number of logical records 

in the prime data area, as contained in filenameP of the DTFIS table. 


The format of the WRITE NEWKEY imperative macro instruction for load- 
ing or extending the file is: 








6 OPERATION 6 






OPERAND 
{ filename 


[name] (1) } , NEWKEY 


POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTFIS declarative macro 
instruction in the program. 


(1) — indicates that register 1 has been preloaded with the address 
of the DTFIS macro instruction. 


POSITIONAL PARAMETER 2 


NEWKEY -— indicates that a new record is to be written into an ISAM 














file. 
Examples: 
LABEL $6 OPERATIONS OPERAND 6 
! 10 16 
wetres ciseces 
aitit WRIT sf feueas ALI EL Pou ye Pa Ps 
pitas | PWR TET [Cut ONTEWKVE GY] poy pe pd 
po tua Pye ys |r peste fg pe Perey ea epee a 
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NOTES: (1) Assuming register 1 has been preloaded with the address 
— of EMPLMST and one of the two forms of the WRITE NEWKEY 
macro instruction has been executed successfully, the 
eight-byte field in the DTFIS addressable file table labelled 
EMPLMSTH will hold the ID of the physical record area con- 
taining the new record. 


(2) If an error or warning condition has occurred, the two-byte 
field in the file table labelled EMPLMSTC will contain an 
indication of the condition. 


A. IOAREAL Area for Blocked Records 


LOGICAL RECORD n 





DATA AREA (NRECDS) 


B. IOAREAL Area for Unblocked Records 





Figure 4-7. IOAREAL Area Formats for Loading or Extending ISAM Files 


4.2.3.2.3. ENDFL Macro Instruction 


The ENDFL (end file load) macro instruction calls on a transient routine 
which terminates the file loading or extending functions for the file. Any 
remaining unwritten records, together with an end-of-file record, are written 
on the disc. Also, any required index processing is performed. 


The format of the ENDFL macro instruction is: 












Bb OPERATION 6 OPERAND 


filename 


ta | 





[name] 
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POSITIONAL PARAMETER 1 














filename — is the label of the corresponding DTFIS declarative macro 
instruction in the program. 
(1) — indicates that register 1 has been preloaded with the 
address of the DTFIS macro instruction. 
Example: 
LABEL 6 OPERATION & OPERAND 6 
1 10 16 
Lut y WOT te RC HT OR Da Obs Ven Yes al Sees Vr cdo Oe 
piu tit oe ie. M pode se te 
4.2.3.3. Record Insertion Macro Instructions 
Once an ISAM file has been created, new records can be added to it. Each 
new record is inserted into the proper sequential place in the file according 
to its key. This file processing function is indicated in the DTFIS declara- 
tive macro by equating the IOROUT keyword to the ADD parameter (or to the 
ADDRTR parameter if retrieval functions are to be performed also). ~ 
eae” 


Records for insertion are supplied in the same way as when the file was 
created; that is, in a work area in either the blocked or unblocked format. 
The DTFIS keyword parameters describing the records (KEYLEN, KEYLOC, 
NRECDS, RCFM, AND RCSZ) must have the same specifications as when the 
file was originally created. 


The imperative macro instructions, WRITE NEWKEY and WAITF, are used to 
add records to an ISAM file. The form of the WRITE NEWKEY instruction for 
adding to the file is the same as that used for loading or extending the file, 
although the functions performed are different. However, when inserting 
records in a file, WRITE NEWKEY must be followed by WAITF. The WAITF 
macro instruction should not be issued when loading a file. 


In the course of adding records to the file, cylinder and/or overflow areas 
will become filled as records are displaced from prime data areas into 
overflow areas. After each WAITF instruction, three user-program addressable 
fields in the DTFIS file table reflect the following changes in the file: 


a filenameA: a two-byte counter of the number of prime data cylinders having 
full cylinder overflow areas; counter is set to 0 if cylinder 
overflow is not used. 


se 


mw filenamel: a two-byte counter of the number of unfilled tracks in the inde- 
pendent overflow area; counter is set to 0 if the file has no in- 
dependent overflow area. 
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w filenameO: a two-byte counter of the total number of overflow records (in 
ee cylinder and/or independent overflow areas). 


In addition to these fields, filenameP, a four-byte counter of the total number of 
prime data records, is available. 


4.2.3.3.1. WRITE NEWKEY Macro Instruction 


This macro instruction inserts a new record into an existing file. Before 
issuing the WRITE NEWKEY macro instruction, the problem program must 
have stored the logical record and its key in the WORKL working storage 
area in either of the formats illustrated in Figure 4—5. The following actions 
are performed in response to this macro instruction: 


mw A search through the indexes is made to locate the new record’s prime 
data track. The track is then searched to locate the physical record 
area into which the new record is to be inserted. 


m The track is rewritten, inserting the new record into its correct position 
and shifting the other records toward the end of the track. 


m™ The last logical record displaced by the shifting process is written into the 
overflow area associated with the prime data cylinder (that is, into the 
cylinder overflow area if possible; otherwise, into the independent over- 
flow area). In either case, the record is inserted into a linked sequence of 
overflow entries, the beginning of which is pointed to by the overflow entry 
See in the track index. 


m The normal track index entry is adjusted to reflect the new highest key in 
the prime data track. 


To ensure that all the actions initiated by the WRITE NEWKEY macro in- 
struction have been completed, a WAITF macro instruction must be executed. 
When control is returned from the latter, the WORKL area is available for 
further insert records. The record just inserted is no longerin WORKL. 


The format of the WRITE NEWKEY macro instruction is: 







% OPERATION 6 OPERAND 


filename 


{ (1) 









| NEWKEY 


POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTFIS declarative macro 
instruction in the program. 


(1) — indicates that register 1 has been preloaded with the address 
of the DTFIS macro instruction. 
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POSITIONAL PARAMETER 2 


NEWKEY — indicates that a new record is to be written into an ISAM file. 


Examples: 







OPERAND 





LABEL & OPERATION 6 
0 







EMPUEMSiIT IN EWKEY {| pi ter Ppp 
(1) » NEW K EY pee tara Lary ra bai di 


pe tp pape tap pi fs 

















NOTES: (1) Assuming register 1 has been preloaded with the address 
of EMPLMST and one of the two forms of the WRITE NEW- 
KEY macro instruction, followed by a WAITF macro in- 
struction, has been executed successfully, the eight-byte 
field in the DTFIS addressable file table labelled EMPLMSTH 
will hold the disc address (ID) of the physical record area 
containing the new record. 


(2) If an error or warning condition has occurred, the two-byte 
field in the file table labelled EMPLMSTC will contain an 
indication of the condition. 


4.2.3.3.2. WAITF Macro Instruction 


This macro instruction ensures that the transfer of a record between main storage 
and a direct access storage device has been completed. It must be issued before 
the program attempts to process another record. Any exceptional (error or status) 
conditions detected during the execution of the WAITF instruction are reflected 
in the DTFIS filenameC field when control is returned to the problem program. 


The format of the WAITF macro instruction is: 















Bb OPERATION 6 OPERAND 


{ co } 





POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTFIS declarative macro 
instruction program. 


(1) — indicates that register 1 has been preloaded with the address 
of the DTFIS macro instruction. 
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Example: 


LABEL 6 OPERATION 6 OPERAND 6 
10 16 


pre ae tori tp tir rr ie tipper ep terrier tiriarits 





EMPL MST 


4.2.3.4, Random Processing Macro Instructions 


Individual logical records can be retrieved in random order for processing and 
updating. The record to be retrieved from the file is designated by its key, and, 
in the case of an updating operation, is written back into the file. 


The random retrieval (and updating) file processing function is indicated in the 
DTFIS macro instruction by equating the IOROUT keyword to RETRVE (or 
ADDRTR if new record insertions are also to be performed), and the TYPE key- 
word to RANDOM (or RANSEQ if sequential processing functions are also to be 
performed). 


Three imperative macro instructions are used in the random processing of an 
ISAM file: READ KEY, WRITE KEY, and WAITF. The WAITF instruction has 
Nee the same significance as described in 4.2.3.3.2. 


4.2.3.4.1. READ KEY Macro Instruction 


This macro instruction initiates the retrieval of a single logical record from an 
ISAM file. Before issuing the instruction, the problem program must have stored 
the key of the record to be retrieved in the main storage area equated to the 
KEYARG keyword parameter of the DTFIS declarative macro instruction. In 
response to the READ KEY macro instruction, the hierarchy of indexes is 
searched to determine whether the record is to be retrieved from a prime data 
track or from an overflow chain. When this has been determined, the appropriate 
track or chain is searched and the physical record containing the desired 
logical record is moved into the I/O area equated to the IOAREAR keyword. 


If the WORKR keyword was specified in the DTFIS macro instruction, the 
logical record is moved into the work area equated to WORKR. If the 
IORG keyword was specified, the address of the first character of the 
logical record is placed in the register (2 through 12) equated to IORG. 
In either case, the disc address from which the record was retrieved is 
available to the problem program in the eight-byte DTFIS addressable 
field labelled filenameG (Table 4-7). 


To ensure that the retrieval operation has been completed, the problem 
program must execute a WAITF macro instruction before attempting to 
access the logical record retrieved. 


nee 
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— The format of the READ KEY macro instruction is: 











OPERAND 
filename 


(1) 


B OPERATION 6 






\ KEY 


POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTFIS declarative macro 
instruction in the program. 


(1) — indicates that register 1 has been preloaded with the address 
of the DTFIS macro instruction. 


POSITIONAL PARAMETER 2 


KEY — indicates that a random retrieval (by key) is to be performed. 


Example: 












LABEL & OPERATION & OPERAND 


10 





16 


ba a ae 
EMPL MIST Ki ElY; pp tt a 


EMPLiMSiTy po tt Pe a 











NOTES: (1) When control returns to the problem program after the 
execution of the WAITF macro instruction, the logical 
record associated with the key in the KEYARG area 
is available either in the WORKR area or in the I/O 
area, depending on the DTFIS declarative macro 
specifications. In the latter case, the register equated 
to the [ORG parameter contains the address of the 
first character of the logical record. The disc address 
of the physical record is available at address EMPLMSTG 
in the DTFIS file table. Indications of any exceptional 
(error or status) conditions are available at address 
EMPLMSTC. 


(2) If the record was retrieved from an overflow area, and 
if it was not the first record in the overflow chain for 
the associated prime data track, the three-byte non- 
first-overflow record reference count at address EMPLMSTR 
is incremented by 1. This count is maintained over the 
life of the file, and is made available to the problem 
program as a possible aid to the user in deciding when 
to reorganize the file. 
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WRITE KEY Macro Instruction 


This instruction initiates the rewriting (updating) of the last record re- 
trieved with a READ KEY macro instruction. If the record is in blocked 
format, with an embedded key (Figure 4—5), the key field must not be 
altered in any way by the user program. The record to be rewritten is 
determined by the key that was supplied in the KEYARG area when the 
last READ KEY instruction was issued. The current contents of the 
KEYARG area are ignored. In response to the WRITE KEY instruction, 
the updated logical record from the WORKR area is moved to the correct 
location in the I/O area, and the record is rewritten. (If the record was 
updated in the I/O area by use of the IORG address, no move is required 
since the updated record is already in the correct location in the I/O 
area.) Before further processing of the file is attempted, the problem 
program must issue a WAITF macro instruction to ensure the completion 
of the rewrite operation. 


The format of the WRITE KEY macro instruction is: 










6 OPERATION 6 OPERAND 


Engage { filename 


og. (a 


POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTFIS declarative macro 
instruction in the program. 


(1) — indicates that register 1 has been preloaded with address 
of the DTFIS macro instruction. 


POSITIONAL PARAMETER 2 


KEY — indicates that the last record retrieved by a READ KEY 
macro instruction is to be rewritten in the file. 


Example: 


6 OPERATION 6 OPERAND 6 
16 


fee Pep eg pe a BR Pp Pe pep pest op) 








EsMiPiLiMISiTi, Ki ElY, pp bp Pt Ps 


Ppp eget pe esp |! op edo | 




















Raf fT fem RST pb pp ta 






UP-7629 
Rev. 2 










4.2.3.5. 


UNIVAC 9400 
DATA MANAGEMENT SYSTEM 


58 


SECTION: PAGE: 


NOTES: (1) When control returns to the problem program after the exe- 
cution of the WAITF macro instruction, the logical record saa 
which was last retrieved by a READ KEY instruction, as 
well as its physical record, have been rewritten onto the 
file. Any indications of exceptional (error or status) condi- 
tions detected during the write and wait operations are 
available at address EMPLMSTC in the DTFIS file table. 


(2) If the problem program has, according to the user’s own 
conventions, tagged the record for deletion, the two-byte 
tagged-for-deletion count at address EMPLMSTT in the 
DTFIS file table can be incremented by the program either 
before or after the rewrite operation. This count is main- 
tained over the life of the file, and is made available to 
the problem program as a possible aid to the user in de- 
ciding when to reorganize the file. 


Sequential Processing Macro Instructions 


Logical records can also be retrieved and updated sequentially. The first 
record to be retrieved can be designated by the beginning of the file, by a 
physical record disc address, by a specified key, or by any key greater 
than or equal to a specified value. The SETL macro instruction specifies 
which kind of starting point is desired. Individual records are then re- 
trieved in sequence by the GET macro instruction. Where an updating 
operation is to be performed, the individual records are rewritten into the 
file by means of the PUT macro instruction. 


The sequential retrieval (and updating) file processing function is indicated 

in the DTFIS declarative macro by equating the IOROUT keyword parameter 

to RETRVE (or ADDRTR if new record insertions are also to be performed), 
and the TYPE keyword to SEQNTL (or RANSEQ if random processing functions 
are also to be performed). 


To terminate a retrieval sequence, an ESETL macro instruction is issued. 
This ensures that any logical records committed to output by the PUT 
macro instruction are written onto the direct access storage device. After 
the ESETL instruction has been executed, another retrieval sequence can 
be initiated by executing a SETL macro instruction. However, if RANSEQ 
was specified for the TYPE keyword in the DTFIS declarative macro, the 
READ KEY and WRITE KEY macro instructions may be issued. 7 


4.2.3.5.1. SETL Macro Instruction 


This instruction initializes a retrieval sequence. It specifies the file from 
which the records are to be retrieved and the point at which the retrieval 
is to start. For the starting point, the SETL macro instruction can 

specify any of the following: 













UP-7629 
Rev. 2 






UNIVAC 9400 


DATA MANAGEMENT SYSTEM a7 


SECTION: PAGE: 


m The label of an eight-byte ID area containing the disc address (ID) 
al of the first physical record to be retrieved; 


m A register containing the address of an eight-byte ID area; 


m That the retrieval sequence is to start with the first logical record of 
the file; 


m That the area equated to the KEYARG keyword parameter contains the 
key of the first logical record to be retrieved; 


m That the KEYARG area contains a value against which the key of the 
first logical record to be retrieved must test greater than or equal to. 


When control is returned from the SETL macro instruction, the retrieval 
sequence can begin. 


The format of the SETL macro instruction is: 










6 OPERATION & OPE RAND 





: (r) 
eo 2 BOF 


1 
(1) GKEY 
KEY 





POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTFIS declarative macro 
instruction in the program. 


(1) — indicates that register 1 has been preloaded with the 
address of the DTFIS macro instruction. 


POSITIONAL PARAMETER 2 


idname — is the label of an eight-byte area containing the ID (disc 
address in the form MBBCCHHR) of the first record. 


(tr) — indicates that the designated general register (2 through 
12) has been preloaded with the address of an eight-byte 
area containing the ID, as described for idname. 


BOF — indicates that the retrieval sequence is to begin with the 
first logical record of the file. 


GKEY  - indicates that the retrieval sequence is to start with the 
first logical record whose key is greater than or equal to 
the value in the area equated to the KEYARG keyword 
parameter. 
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KEY — indicates that the area equated to the KEYARG keyword not 
parameter holds the key of the first logical record to be 
retrieved. 
Examples: 





LABEL 








& OPERATION 6 OPERAND 
10 


PEMSiT C4) ee pba pp bpp pir terri ts 
peo tea ea Pyrat 


got py iy pe ae 














1. Register 4 contains the address of an eight-byte area containing the 
ID of the physical record whose first logical record will be made 
available to the program when the next GET macro instruction is 
executed. If the eight-byte ID area is outside the file limits, when 
control is returned following the SETL instruction, bit 4 will be 
set in the two-byte error indicator location specified by DTFIS 
addressable field EMPLMSTC. Any GET instructions attempted without 
an intervening and correct SETL instruction will have no effect, and 
will also return with bit 4 set in field location EMPLMSTC. 


2. The area equated to the DTFIS keyword parameter KEYARG holds a 
value which is the lower key limit for retrieval. If, for example, the ht 
KEYARG area holds 400101, the retrieval sequence starts with the 
lowest key greater than or equal to 400101. If it is determined that all 
keys in the file are less than 400101, when control is returned fol- 
lowing the SETL instruction, bit 3 will be set in addressable field 
location EMPLMSTC. Any GET instruction attempted without an inter- 
vening and correct SETL instruction will be null, and will also return 
with bit 3 set in EMPLMSTC. If, on the other hand, all keys in the 
file are greater than 400101, the first GET instruction will simply re- 
trieve the first logical record with a key greater than 400101. 


3. The specified KEYARG area holds the key of the first logical record 
to be retrieved. For example, if the area holds a key equal to 400101, 
the first GET instruction will retrieve the logical record whose key 
is 400101. If it is determined that no record in the file has this key, 
control is returned from the SETL instruction, with bit 3 of addressable 
field location EMPLMSTC set. Any subsequent GET instruction attempted 
without an intervening and correct SETL will have no effect, and will 
also return with bit 3 set in field location EMPLMSTC. 
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4.2.3.5.2. GET Macro Instruction 


This instruction retrieves the next logical record in sequence. It must be part 
of a valid retrieval sequence initiated by a SETL macro instruction. If the 
physical record containing the next logical record is not already in main 
Storage, the GET instruction causes it to be read into the I/O area equated 
to the IOAREAS keyword in the DTFIS declarative macro. (The logical 
record is made available to the problem program either in a work area or in 
the I/O area.) If the WORKS keyword of the DTFIS declarative macro was 
equated to YES, the GET instruction specifies the address of a work area 
into which the logical record is transferred. If WORKS=YES was not speci- 
fied, a general register number (2 through 12) must have been equated to the 
DTFIS keyword IORG. In this case, execution of the GET macro instruction 
makes the main storage address of the logical record available in the 
specified register. 


If the GET instruction requires the reading of a new physical record, and if 
a PUT macro instruction was executed for any logical record in the previous 
physical record, then the previous physical record, as updated, is written 
back onto the direct access storage device before the new record is tread. 


The format of the GET macro instruction is: 





OPERAND 


filename workname 
ta} fot] 


LABEL &B OPERATION 6 








POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTFIS declarative macro in- 
struction in the program. 


(1) — indicates that register 1 has been preloaded with the address 
of the DTFIS macro instruction. 


POSITIONAL PARAMETER 2 


workname — is the label of the work area into which the record is to be 
transferred. 


(0) — indicates that register 0 has been preloaded with the address 
of the work area into which the record is to be transferred. 


Positional parameter 2 is required only if the WORKS keyword of the DTFIS 
declarative macro was equated to YES. 


PAGE: 









61 














UP-7629 
Rev. 2 








UNIVAC 9400 
DATA MANAGEMENT SYSTEM 






SECTION: PAGE: 





Examples: 


LABEL 6B OPERATION 6 OPERAND 6 
10 16 
T 


] 
Bei ET 4 EMPL IMSiT BE MIRGD i lye ba pp Ppp a te 
2. aie i cecoreae 





ry 


The next logical record of EMPLMST is transferred into the work area 
labelled EMRCD. If the record format is unblocked, the key is also trans- 
ferred. Any abnormal conditions are indicated by the bit settings in 
addressable field location EMPLMSTC. The disc address from which 

the logical record was transferred is available to the problem program 

at addressable field location EMPLMSTG. 


No 


The register equated to the IORG keyword parameter (for example, register 
4) holds the address of the first character of the logical record. If the 
EMPLMST file is in the unblocked format, the key of the record is at the 
beginning of the I/O area equated to the IOAREAS keyword parameter. 

If the file is in the blocked format, the key of the logical record is in the 
standard location, as specified by the value equated to the KEYLOC key- 
word parameter. Addressable fields EMPLMSTC and EMPLMSTG have the 
same Significance as in the preceding example. 


4.2.3.5.3. PUT Macro Instruction 


This instruction indicates that the last record retrieved by a GET macro 
instruction has been updated and is to be rewritten on the direct access 
storage device. It must be part of a valid retrieval sequence initiated by 

a SETL macro instruction and must follow a GET macro instruction. It is 
only through the execution of the PUT macro instruction that updating takes 
place in a sequential retrieval operation. If a record retrieved by a GET 
instruction is not updated, there is no need to execute a PUT instruction. 


If the file is in the unblocked format, the record is rewritten immediately. 

If the file is in the blocked format, the PUT macro instruction sets an in- 
dicator in the DTFIS file control table such that the physical record con- 
taining the updated record is rewritten when the next physical record is to 
be accessed (that is, when all logical records in the current physical record 
have been processed). 


Like the GET macro instruction, the PUT macro instruction has two forms: 
the work area form and the I/O area form. If the WORKS keyword of the 
DTFIS declarative macro was equated to YES, then the PUT macro instruc- 
tion must specify the address of the work area from which the updated 
record is to be transferred to the IOAREAS area. This may be the same 
area as specified in the previous GET macro instruction, or it may be a 
different area. Note that if the record format is unblocked, only the logical 
record is transferred back to the I/O area. 
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If the WORKS keyword of the DTFIS declarative macro was not equated 

a to YES, then a general register number (2 through 12) must have been 
equated to the IORG keyword parameter, and the address of the logical 
record was supplied in the specified register when the last GET macro 
instruction was executed. In this case it is assumed that the record was 
updated at the specified address in the IOAREAS area. 


Under no circumstances may the key field of the updated record be altered. 


The format of the PUT macro instruction is: 






OPERAND 


filename [ ee 
{ (1) } j (0) | 


+ OPERATION 6 












POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTFIS declarative macro 
instruction in the program. 


(1) — indicates that register 1 has been preloaded with the 
address of the DTFIS macro instruction. 


POSITIONAL PARAMETER 2 


workname — is the label of the work area from which the record is to 
be transferred. 


(0) — indicates that register 0 has been preloaded with the 
address of the work area from which the record is to be 
transferred. 


Positional parameter 2 is required only if the WORKS keyword of the 
DTFIS declarative macro was equated to YES. 











Examples: 
LABEL tb OPERATION 6 OPERAND 6 
| 10 16 
se eee i P, Li M/S iT Ole pp be bs Pa 
pop fic kegel nahi eal sete 
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1. The logical record last retrieved from EMPLMST is replaced by a record 
in the work area whose address is specified in register 0. If EMPLMST nant 
is in unblocked format, the physical record is rewritten from the 
IOAREAS area. If EMPLMST is in blocked format, an indicator in the 
DTFIS file control table is set to initiate rewriting of the physical 
record before the next record is read into the I/O area. 


2. The logical record, whose address was supplied in the register 
specified by the IORG keyword parameter when the preceding GET 
macro instruction was executed, is assumed to have been updated. 
Refer to Note 1 for an explanation of when the physical record 
is rewritten. 


4.2,.3.5.4. ESETL Macro Instruction 


This instruction terminates a retrieval sequence initiated by a SETL 
macro instruction. If there are any updated logical records which have 

not yet been rewritten, they are rewritten at this time. After the ESETL 
instruction has been executed, another retrieval sequence can be initiated 
by means of a SETL instruction. 


The format of the ESETL macro instruction is: 





6 OPERATION 6 OPERAND 


filename 
of 





POSITIONAL PARAMETER 1 


filename — is the label of the corresponding DTFIS declarative macro 
instruction. 


(1) —indicates that the address of the DTFIS macro instruction 
has been preloaded into register 1. 


Examples: 


LABEL & OPERATION 6 OPERAND 6” 


1 10 16 

peat Heer PiLiMiS iT 

Peet | eset Gudea ti a 
line stog Sepene: aaest. ag Poe pe theif oes he fA pe eh oh $s 


4.2.3.5.5. DMEAR Macro Instruction 











This instruction provides information for fatal hardware or logical errors 
that have taken place in opening, processing, or closing a Data Manage- al 
ment file (3.4). 
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5. DISC SPACE MANAGEMENT 


GENERAL 


When executing jobs in a multiprogramming environment, it is always difficult (and 
often impossible) for the individual programmer to know the exact organization of 
particular direct access volumes. There is, nevertheless, a need for most jobs to 
create and process files on these volumes. The creation and processing of direct 
access files require means for allocating space, releasing unused space, scratching 
files when no longer needed, obtaining label and extent information, and renaming 
files. These procedures are required by Job Control and various service and utility 
programs. 


Disc Space Management routines for the UNIVAC OS/4 Operating System (OS/4) 
provide an efficient and completely automatic space accounting and maintenance 
feature which relieves the user of the responsibility of knowing the precise contents 
of direct access volumes. These routines also permit the resolution of competing 
demands for allocation, and establish standard interfaces with the user, Job 
Control, and the service and utility programs. 


The Disc Space Management routines are set up to handle individual direct access 
volumes. When processing multivolume files, the user is responsible for submitting 
all related volumes. 


PROGRAMMING APPROACH 


Disc Space Management in OS/4 comprises a set of transient service routines 
which allocate space to files on direct access volumes. This is accomplished by 
maintaining the volume table of contents (VTOC) through standard procedures 
for all files — system, temporary, and those considered permanent by the user. 
The VTOC is a permanently allocated, unmovable file which exists on every direct 
access volume by the direct access volume initialization program. The contents 

of the VTOC file are a format label, or set of format labels, for each file on 

the volume and for all unused space on the volume. 


The Disc Space Management routines maintain the VTOC by creating format labels for 
new files and deleting format labels for files removed from the volume. When a file is 
to be created, unused space is found for it by searching the appropriate labels in the 
VTOC, allocating the space as the extents of the file, and removing it from free space. 
When a file is deleted, the format label for the file is removed from the VTOC; the 
extents previously assigned to the file are again available for allocation. 


PAGE: 
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5.3. 





Disc Space Management includes four functional areas, two of which are concerned 
with basic space accounting, and two of which provide support operation capability. 


™ Space Accounting Routines 
ALLOCATE — allocates initial direct access space to a file. 


SCRATCH — deletes a file or portion of a file by deleting its associated extents 
and/or labels in the VTOC. 


= Support Routines 
RENAME — changes the name of a file. 
OBTAIN — enables direct access to any label in the VTOC. 


System macro instructions are provided for effecting Supervisor-assigned linkages 
to the ALLOCATE, SCRATCH, RENAME, and OBTAIN routines. 


Disc Space Management functions are used by various components of OS/4 in response 
to implicit and explicit requests introduced through input job streams. For example, 
the space requested for a new or updated direct access file in an EXT statement 
included in a user’s job control language file definition set is obtained for Job Control 
through an interface with the ALLOCATE routine. The OBTAIN function is used by 
the librarian routines to gain access to label and extent information required for file 
initialization. The ALLOCATE, SCRATCH, and RENAME functions are employed by 
utility programs. A SCRATCH ALL request deletes all files on a volume whose 
expiration date either predates or equals the present date. 


DATA INPUT 


The precise input to Disc Space Management is dependent upon the particular 
function to be exercised. The contents of the VTOC, however, serve as input (and 
output) to some degree for all of the Disc Space Management routines. The structure 
of the VTOC and the techniques of recording the use or availability of direct access 
space are therefore discussed in this section. 


The VTOC is a file which contains a set of format labels for each file and for all 

unused space on a direct access volume. The extent or length of a VTOC is variable, 

as specified at the user’s installation. The starting address of the VTOC is recorded 

in bytes 11—15 of the standard volume label, and can be anywhere on the volume 
following the IPL control record(s) and volume label(s); the starting address is recorded 
in the form CCHHR. This address must be that of an integral track boundary unless 
the VTOC starts on track 0 of cylinder 0 and shares that track with the IPL control 
record and volume label(s). 


The VTOC extent must be only one area of contiguous tracks on one or more 
contiguous cylinders. 
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Format Labels 


For each file contained on a direct access volume, there exists a corresponding set 
of format labels in the VTOC of the volume. Each such set indicates the attributes 
and extents of the file and may contain up to two format labels. Each physical 

label is 140 bytes in length; this is subdivided into a 44-byte key and 96-byte data 
area. Information contained in these labels is used by the Data Management routines 
to control access to files. In the case of multivolume direct access files, there is 

a set of format labels for the file in the VTOC of each volume. 


There are six formats of VTOC format labels defined as follows: 
= Format 1 Label 


This label identifies any file on a direct access volume except for the VTOC file 
itself. There must be one format 1 label for each file or part of a file on each 
volume. Up to three noncontiguous areas, or extents, occupied by the file can 
be identified in the format 1 label. One format 2 label or one format 3 label 
can be chained to a format 1 label. 


= Format 2 Label 


This label provides additional description for an indexed sequential file. If present, 
the format 2 label is chained to a format 1 label. 


= Format 3 Label 


This label is used if the file consists of more than three extents. Up to 13 additional 
extents can be identified in the format 3 label. If present, the format 3 label is 
chained to a format 1 label. 


= Format 4 Label 


This label describes the VTOC itself. It is always the first record in the VTOC. 
No other labels are chained to the format 4 label. 


= Format 5 Label 


This label describes up to 26 noncontiguous extents that are available for allocation 
on a volume. It is always the second record in the VTOC. Several format 5 labels 
may be chained together if more than 26 noncontiguous extents are available on 
the volume. 


The five previously described labels are basic to the logic of Disc Space Management. 
See 2.3.1 for complete format descriptions of these labels. 


For conceptual purposes it is helpful to think of a sixth type of VTOC format label, 
a format 0 label, which represents available space within the extent of the VTOC 
itself. The format 0 label contains all binary zeros. When a format 1, 2, 3, or 5 label 
is deleted from the VTOC, a format 0 label is written in its place. 
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Volume Contents Following Initialization 


Before any data has been written on a direct access volume, the volume contains a 
single VTOC file, which is written by the disc prep routine (UNIVAC OS/4 General 
Disc Prep Routine Programmer Reference, UP-8014 (current version)). Space occupied 
by the VTOC is described within the format 4 label. The remainder of the space on the 
volume (with the exception of that occupied by the IPL control record, volume labels, 
and IPL program, if present) is available to be allocated to files as they are created, 
and is described in the second record of the VTOC, the format 5 label. All other 
records of the VTOC are predefined as format 0 labels. 


If the VTOC is recorded on cylinder 0 immediately following the last (or only) volume 
label, or is recorded at the end of the entire volume, the available space, after 
initialization, is a single area of contiguous space extending, respectively, from the 

end of the VTOC to the end of the volume, or from volume labels to the beginning 

of the VTOC. 


If, on the other hand, the VTOC does not immediately follow the volume labels or 
appears at the end of the volume, the available space is two areas of contiguous 
storage, one preceding the VTOC and a second following it. 


Each available extent is recorded in a separate entry in the format 5 label. The 
entry contains the relative address of the first track of the extent, the number of 
complete cylinders in the extent, and the number of tracks in addition to complete 
cylinders. 


The total number of tracks accounted for in the VTOC is, at any time, the total 
number of tracks on the volume. Used tracks are recorded in format 1, 3, and 4 
labels, while available tracks are recorded in format 5 labels. 


Use/Availability Recording Technique 


At the time a file is created, space is acquired by the ALLOCATE routine by scanning 
the format 5 labels. When space is found, the requested amount is subtracted from 
that described in the format 5 labels. A format 1 label is constructed for the new file 
and written into the VTOC at the first available location (format 0 label). 


When a file is deleted, its format 1 label and format 2 or 3 label, if present, are 
replaced by format 0 labels. The extents previously occupied by the file are returned 
to available space by adding the indicated quantities back into the format 5 labels. 


When a portion of a file is deleted, only specified extents are deleted from the file. 
If all extents are deleted from a format 3 label, the label is replaced by a format 
0 label. 


A file is described by a set of one or two VTOC format labels according to the type 
of file organization and the number of extents in the file. The following combinations 
are possible: 


1. A single format 1 label for a nonindexed-sequential file of not more than three 
extents or indexed-sequential file’s second and subsequent volumes. 


2. <A format 1 label chained to a format 3 label fora nonindexed-sequential file 
with more than three extents. 
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38. A format 1 label chained to a format 2 label for an indexed-sequential file 
(only the first volume of the file). 


The set of VTOC format labels corresponding to a file are neither necessarily 
contiguous nor in a defined order within the VTOC. With the exceptions of the 
format 4 label and the first format 5 label, new labels are written into locations 
nearest the beginning of the VTOC as they are created; the relationship of any two 
of these labels is indicated through chain addresses. 


Capacity of the VTOC 


During the allocation process, Disc Space Management routines must take into account 
the availability of space for both the extents of the file on the volume and the file’s 
corresponding labels in the VTOC. Space required for the expansion of format 5 labels 
is an additional consideration. 


The format 4 label contains a count of the number of available slots within the VTOC 
at any time. This count is interrogated by Disc Space Management routines, prior to 
allocating space, to determine whether there is sufficient space to accommodate the 
required new format labels for the file. If not enough slots are available, allocation 

is not performed; there is no provision for dynamic extension of the VTOC. 


A UNIVAC 8411 Disc Storage volume accommodates 16 140-byte VTOC format labels 
on a single track, and up to 160 140-byte VTOC format labels can be contained on a 


complete cylinder. A UNIVAC 8414 or 8424 Disc Storage volume accommodates ~<~ 


25 140-byte VTOC format labels on a single track, and up to 500 VTOC format 
labels on a complete cylinder. 


IMPERATIVE MACRO INSTRUCTIONS 


The imperative macro instructions supplied for Disc Space Management are ALLOC, 
SCRTCH, RENAME, and OBTAIN. The ALLOC and SCRTCH macros are concerned 
with basic space accounting (allocating and deleting file space), while RENAME and 
OBTAIN provide support operation availability (changing a file name and enabling 
access to any label). Each of these macros is discussed in detail, along with its 
associated error conditions, in the following paragraphs. 


ALLOC Macro Instruction 


The ALLOC macro instruction is issued to request the services of the Disc Space 
Management Allocate routine. Allocation is performed on a volume-by-volume basis. 
For each volume of a file, the inputs to the Allocate routine are the File Control 
Block (FCB) of the file and the corresponding Extent Request Block (ERB). 














b OPERATION 6& OPERAND 






piocb-name-of-fcb 


{ \ { sali 
(1) ; (0) 
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POSITIONAL PARAMETER 1 


piocb-name-of-fcb — symbolic address of the physical I/O control block containing 
the FCB. 


(1) — indicates that register 1 has been preloaded with the physical 
I/O control block address containing the FCB. 

POSITIONAL PARAMETER 2 

piocb-name-of-erb — symbolic address of the physical I/O control block containing the 


ERB. 


(0) — indicates that register 0 has been preloaded with the physical 
1/O control block address containing the ERB. 


SCRTCH Macro Instruction 


This macro instruction is issued to request the services of the Disc Space Management 
Scratch routine. This routine eliminates a file from a volume, releases unused extents, 
or eliminates all files with expired dates from a volume. 














6 OPERATION 6 OPERAND 








aeawliee extent-number 
C (1) } Sh = 
(0) 


SCRTCH 


POSITIONAL PARAMETER 1 
param-list — the address of a parameter list containing the following: 


6-byte volume serial number of the current volume (this is checked 
against the standard volume label on the disc); 


44-byte file identifier; however, this file identifier is not needed 
when positional parameter 2 specifies ALL. 


(1) — indicates that register 1 has been preloaded with the address of a 
parameter list. 


POSITIONAL PARAMETER 2 


extent-number — used for partial scratch; it indicates the last extent to be saved. 

ALL — all files of the specified volume (with expired dates) will be 
scratched. 

(0) — indicates that register 0 contains the error information established 


in the Allocate routine. 


NOTE: The second operand is not needed for scratching entire individual files. 
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RENAME Macro Instruction 


The RENAME macro instruction is issued to request the services of the Disc Space 
Management Rename routine. This routine changes the file identifier of an existing 
file format 1 label. 














Bb OPERATION 6 
RENAME 


OPERAND 


{ param-list \ 
(1) 





POSITIONAL PARAMETER 1 

param-list — the address of a parameter list containing the following: 
44-byte old file identifier 
44-byte new file identifier 


6-byte volume serial number 


(1) — indicates that register 1 has been preloaded with the address of the 
parameter list. 


OBTAIN Macro Instruction 


This macro instruction is issued to request the services of the Disc Space Manage- 
ment Obtain routine. This routine enables access to any user label in the VTOC. 

If a 44-byte filename is supplied as input, the absolute track address (in the form 
cechhr) of the format 1 label is placed in the first five bytes of the data area, 
followed by the 96-byte data area of the format 1 label. If an address ID (cchhr) 

is supplied as input, the entire key and data area of the specified label are returned. 











% OPERATION 6 
OBTAIN 


OPERAND 


{ param-list 
(1) 








POSITIONAL PARAMETER 1 
param-list — the address of a parameter list containing the following: 


1-byte request type; if the byte contains 0, request by key; if the byte 
contains 1, request by ID 


6-byte volume serial number; if request by key is specified, the 
parameter list includes a 44-byte file identifier and a 101- 
byte data area. If request by ID is specified, the parameter 


ime 


list includes a 5-byte address ID (of form cchhr) and a <_ 


140-byte data area. 


(dt) — indicates that register 1 has been preloaded with the address of the 
parameter list. 
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5.5. ERROR CODES 


Disc Space Management error codes are returned to the caller in the least significant ~ 
byte of register 0 for the Allocate and Scratch routines, and register 1 for the Obtain 
and Rename routines. If the error code is from the Allocate routine and indicates that 
the Scratch routine must be called, register 0 is prepared for entry to the Scratch routine 
with the last extent number to be saved for the file in the upper halfword of register 0. 
5.5.1, Allocate Routine Error Codes 
mw Error Code 1. Invalid Parameter Specification 
Causes: — For a new file, the identifier already exists in the VTOC. 
— For an old file, the identifier could not be found in the VTOC. 
— The file identifier in the FCB started with binary zeros. 
— The extent request block has a count of zero. 
Result: The VTOC remains intact; no further action is required. 
User Action: Print VTOC to examine directory of file identifiers. Make sure 
job control stream contains an LBL card with a file identifier. 
Check FCB and extent request block for invalid parameter 
specification. 
g Error Code 2. No Room in VTOC 
see 


Causes: — There is not enough room in the VTOC to assign file labels 
to the user, or to allow for expansion of the VTOC file labels. 


— For a new file, three VTOC labels are needed. 


— For an old file, two VTOC labels are needed. 


Result: The VTOC remains intact; no further action is required. 


User Action: Eliminate unused files by means of the Scratch routine. Also, 
the size of the VTOC on the disc can be expanded by use of 
the Disc Preparation routine. 


m Error Code 3. Input/Output Error 


Causes: An unacceptable disc error has occurred while processing the VTOC. 


Result: The VTOC has been compromised. It is impossible to continue 
using the disc in its present state. 


User Action: Since the data records of the file could be intact, they could be 
copied to another disc. Also, the Disc Preparation routine could 
be called to reprepare and assign alternate tracks in the VTOC 
area only; then the file labels could be reinstated by requesting 
absolute allocation for required areas on the disc. 
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gw Error Code 4. 


Causes: 


Result: 


User Action: 


@ Error Code 5. 


Causes: 


Result: 


User Action: 


@ Error Code 6. 


Causes: 


Result: 


User Action: 


gw Error Code 7. 


Causes: 


Result: 


User Action: 


m Error Code 8. 


Causes: 


Result: 


User Action: 


Invalid PUB or Volume Serial Number 


— No disc PUB has been found with the correct VSN. 


-— The volume serial number in the Extent Request Block does not 
match the one in the standard volume label. 


The VTOC remains intact; no further action is required. 
Check DVC card for invalid logical unit number. Also check job 


stream for errors in VOL cards. The proper volume serial number 
was probably not specified for Disc Preparation routine. 


Cannot Allocate Absolute Request 


The area specified by an absolute EXT request is not available 
as free space on the disc. 


The VTOC is not intact; Scratch routine must be called to reinstate 
the VTOC. 


Eliminate file using required area or alter request. 
Contiguous Request Unable to be Assigned 


User specified request cannot be satisfied by any contiguous free 
space on the disc. 


The VTOC is not intact; Scratch routine must be called to reinstate 
the VTOC. 


Could make the same request again, specifying noncontiguous. 
More than 16 Extents 


The maximum of 16 extents assigned to the file on this volume has 
been reached. 


The VTOC is not intact; Scratch routine must be called to reinstate 
the VTOC. 


Reorganize the file if possible. 


No Room on Disc 


While attempting to satisfy a noncontiguous request, the Allocate 
routine exhausted all available free space on the disc. 


The VTOC is not intact; Scratch routine must be called to reinstate 
the VTOC. 


The disc is full. 
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5.5.2. Scratch Routine Error Codes 


g@ Error Code 1.No Room in VTOC ae 
Causes: This error would only occur when a partial Scratch is specified; 
that is, positional parameter 2 of the SCRTCH macro instruction 
specifies the last extent number. One VTOC label is needed for 
possible expansion of the VTOC labels. 
Result: The VTOC is intact; no further action is required. 
User Action: Could do a complete Scratch rather than a partial Scratch. 
Error Code 2. Invalid File Identifier (Not for SCRATCH ALL) 
Causes: — The identifier could not be found in the VTOC. 
— The file identifier in the parameter list was not in EBCDIC code. 
Result: The VTOC remains intact; no further action is required. 
User Action: Print directory of file identifier. Check parameter list for valid 
identifier. 
Error Code 3. Input/Output Error 
Same as described for error code 3 under Allocate Routine Error Codes. ae 
Error Code 4. Volume Serial Number Error ew 
Causes: — No disc PUB has been found for the specified VSN. 
— The volume serial number in the parameter list does not match 
the one in the Standard Volume Label. 
Result: The VTOC remains intact; no further action is required. 
User Action: Check parameter-list against job control stream. Check DVC card 
for invalid logical unit number. The proper volume serial number 
was not specified for the Disc Preparation routine. 
5.5.3. Rename Routine Error Codes 
gw Error Code 1. Volume Serial Number Error 
Causes: — No disc PUB has been found for the specified VSN. 
— The volume serial number in the parameter list does not match 
the one in the Standard Volume Label. 
— A blank VSN is illegal. 
Result: The VTOC is intact; no further action is required. 
User Action: Check DVC card for invalid logical unit number. The proper volume ad 


serial number was not specified for the Disc Preparation routine. 
Check calling sequence and job control stream for incompatibility. 
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m Error Code 2. File Identifier Not Found 


Causes: Specified 44-byte file identifier is not in the VTOC. 
Result: The VTOC is intact; no further action is required. 
User Action: Check calling sequence against VTOC printout. 


5.5.4. Obtain Routine Error Codes 


m Error Code 1. Volume Serial Number Error 
Same as described for error code 1 under Rename Routine Error Codes. 
@ Error Code 2. File Identifier Not Found or Illegal ID 
Causes: — By key, specified 44-byte file identifier is not in the VTOC. 
— By ID, specified 5-byte ID is not within the VTOC limits. 
Result: The VTOC is intact; no further action is required. 


User Action: Check calling sequence against VTOC printout. 
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we 
APPENDIX A. JOB CONTROL/ 
LOGICAL IOCS 
INTERFACE 
A.l. GENERAL 
In this appendix the various interface label handling procedures between Job Control 
and logical IOCS for both tape and disc files are outlined. 
A.2. LABEL PROCESSING FOR TAPE FILES 
oo Label processing for tape files consists primarily of standard label checks for tape 
ees read (forward and backward) and write operations. 


A.2.1. Expiration Date Field 


The expiration date or retention period field in an LBL Job Control statement 
period controls the expiration date, which indicates the date when the file can be 
scratched. If it is specified as a five-digit EBCDIC operand, it is interpreted as 
an expiration date in the yyddd format, where yy is the year (00 through 99) and 
ddd is the day (001 through 366). If it is specified as a five-character EBCDIC 
operand Rnnnn, it is interpreted as a retention period, where nnnn is the number 
of days the file is to be retained beyond the creation date. In this latter form, the 
number of days is added to the creation date to produce an expiration date, (For 
purposes of this addition, a standard year of 365 days is used.) The expiration 
date is never checked on an input file. 
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General Relationships and Standard Tape Label Checks 


The file serial number (FSN) in an HDR1 label is specified as being the same as 
the volume serial number (VSN) in the VOL1 label of the first volume of the file. 
Thus, all volumes of a multivolume file have an identity which is common to all 
volumes in the file, but unique to a particular run of that file. As such the FSN, 
which may be used as a ‘‘short cut’’ identification of a file, reduces the number 
of changes in the Job Control stream necessary to identify a file. It could also 
be used as an additional validity check when other controls such as the file 
identification field, volume sequence number, or date fields are employed. 


Whenever the VSN in the VOL card or the FSN field of an LBL card is other than 
blank, Data Management assumes that the standard labels include both VOLI and 
HDR1 labels and that the VSN/FSN relationship exists. 


Whenever the VSN in the VOL card and the FSN in the LBL card are both blank, 
Data Management assumes that the standard header labels include an HDR1 label, 
but may or may not include a VOLI1 label, and that if VOL1 labels are present, the 
VSN/FSN relationship may or may not exist. 


If, in processing a file, a VOL card which contains a VSN is presented, Data 
Management assumes that the LBL card includes the correct FSN. Mounting instruc- 
tions are by VSN. The VSN/FSN is checked on input and created on output. If a 
VOL card which contains SCRTCH is presented as the VSN, or an LBL card which 
contains VCHECK is presented as the FSN, mounting instructions are by filename 
and the VSN/FSN is checked on input and created on output. 


If in processing a file, both the VSN in the VOL card and the FSN in the LBL card 
are blank, mounting instructions are by filename and the FSN/VSN relationship is 

not checked. VOLI1 labels, if present, are bypassed. Proper use of the VSN/FSN 
relationship, together with the retention period feature of the LBL card, can reduce 
the number of job control stream changes from run to run and also provide satisfactory 
checks on input and identification of output. 


The following tables outline the standard tape label checks performed for various 
combinations of LBL and VOL entries in the job control stream. A separate table 
is provided for each of the following operations: 


a Tape Output 
@ Tape Input (read forward) 


a Tape Input (read backward) 
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° A.2.3. Tape Output Checks 


JOB CONTROL STATEMENT 


FSN VCHECK 


FSN -blank 


FSN VCHECK 


File tD 


Expiration date: 
Rdddd or yyddd 


Creation date: 
yyddd 


Version number 


Generation 
number 


VOL sequence 
number 


VSN_ blank 


VSN: blank 


VSN-SCRTCH 


VSN -SCRTCH 


VSN=FSN 


If a specific 

VSN is entered, 
an expiration 
date check is 
fatal (go to 
ERROR or 
CANCEL) since 
mounting another 
tape would cause 
a volume label 
check. If FSN is 
SCRTCH or blank, 
an expiration date 
check provides 
opportunity to try 
another tape (see 
operator control). 


TAPE LABEL 
CONVENTIONS 


HORi required. 
VOL1 not re- 
quired but may 
be present. 


Filename 


VOL1 required Filename 


HDR1 required 


VGL1 required Filename 


HDRI1 required 


VOL] required 
HDRI required 


File serial 
number 
(FSN) 





UPDATE 
REQUIRED 


No for Rdddd 
YES for 
yyddd 





LOGICAL 10CS 
OUTPUT CHECKS 


VOLUME 
MOUNTING 


VOL labels are retained if 
present. 


VSN,'FSN relationship is 
not created, 


Invalid combination 


FSN/VSN telationship is 
created on all output reels. 
FSN is typed out when the 
first reel is opened. 


FSN/VSN relationship is 
created on all output reels. 
FSN is typed out when the 
first reel is opened. 


VSN of VOL card must equal 
FSN of LBL card. VSN of 
first VOL of output must 
equal VSN of VOL card. 
FSN/VSN relationship is 
created on all output reels. 
FSN of the first volume is 
not typed out. 


If blank, the seven-character 
label on the DTF for this 

file is placed in file ID. 

If not blank, the 10 is (1) 
left-justified and (2) blank- 
filled in the ID field in HDR1. 


If expiration date is blank, 
current date is used unless 
SET DATE has been used 

in the job contro! stream 

for this run, in which case 
the date for this run is used. 
lf expiration date is Rdddd 
(where dddd is 1-9999), it is 
accepted as a retention cycle, 
added to creation date, and 
placed in expiration date in 
the form yyddd. 

{f not blank and not preceded 
by R, itis placed in expiration 
date (form yyddd). 


\f blank, current date is used 
unless SET DATE has been 
entered in the job control stream 
for this run in which case the 
date for the run is used. 

\f not blank, it is placed in 
creation date in HDRI1. In any 
case, the expiration date of the 
file being overwritten must be 
equal to or less than the crea- 
tion date as determined above, 


If blank, 01 is assumed to be 
the version number. 

tf not blank, version number is 
taken from the LBL card. 


'f blank, 0001 is assumed to be 
the generation number. 

if not blank, generation number 
is taken from the LBL card. 


If blank, 0001 ts assumed for 
the first reel. 

If not blank, VOL sequence 
number is initialized at the 
value in the LBL card. 

On subsequent volumes, VOL 
sequence number is incrementec 
by 1. 
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OPERATOR 
CONTROL 
If job contro! 
stream errors 
exist, go to 
ERROR or 
CANCEL 
routine. 
If incorrect 
tape mounted; 
mount another 
tape and retry 
with R, or 


reject with U. 


Operator may 

not override an 
expiration date. 

A tape without 
proper VOL1 
and/or HDR1 
labels is con- 
sidered unexpired. 
Operator may: (1) 
Mount another tape 
and retry with R, 


(2) Reject with U. 


*MVI Minimum Visual identification — external label used for reel identification must contain at teast the information in this column. 
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A.2.4. Tape Input Checks (Read Forward) 


JOB CONTROL STATEMENT 


LBL 


None 





TAPE LABEL 
VOL CONVENTIONS 
VSN blank HDR1 required. 
VOLI not re- 

quired but may 


be present. 


UPDATE 


MVIT | REQUIRED 


Filename 


FSN VCHECK 


VSN -blank VOLI required 


HDR1 required 


LOGICAL I10CS 
INPUT CHECKS 


VOL labels are bypassed 
if present. 

HDRI Jabel is typed out 

for operator acceptance. 

VSN/FSN relationship is 
not checked, 


HDR1 label is not typed 
out. 

FSN in HDR1 of the first 
reel is typed out. 
VSN/FSN relationship is 
checked. 


FSN=blank 


VSN=SCRTCH 


FSN VCHECK 


FSN-fsn 


File iD 


Expiration date 


Creation date: 
yyddd 


Version number 


Generation 
number 


VOL sequence 
number 


Ce ad 


*MVI — Minimum Visual Identification — external label used for reel identification must contain at least the information in this column. 


VSN-SCRTCH ]|VOL1 required 


HDRI required 


VOL1 required 
HORI required 


VSN-FSN 


If a specific 
VSN is enter- 
ed, an invalid 
HDR] label is 
fatal {go to ER- 
ROR or CANCEL) 
since mounting 
another reel 
would cause a 
volume label 
check. If VSN 
is SCRTCH or 
blank, an HDR1 
check provides 
opportunity to 
try another tape 
(see operator 
control). 





File serial 
number 
(FSN) 


Invalid combination 


HDR1 fabel is not typed 
out. 

FSN in HORI of the first 
reel is typed out. 
VSN/FSN relationship is 
checked, 


VSN of VOL card must 
equal FSN of LBL card. 
VSN of first reel must 
equal VSN of VOL card. 
VSN/FSN relationship is 
checked. 

HDR! not typed out. 
FSN not typed out. 


If blank, file ID is not 
checked. 

If not blank, must be 
equal to file ID in HDR1. 
Does not inhibit type-out 
of HDR1. 


Ignored on input. 


If blank, creation date is 

not checked. 

{f not blank, must be 

equal to creation date in 

HORI. 

Inhibits type-out of HDR1. 
T blank, version number is 

not checked, 

if not blank, must be equal 

to version number in HOR}. 

Inhibits type out of HDR1. 


If blank, generation number 
is not checked, 

(f not blank, must be equal 
to generation number in 
HORI. 

Inhibits typeout of HORI. 


VOL sequence number is 
checked starting with 
number on LBL card 
instead of 1. 

Inhibits typeout of HDR1. 








VOLUME 
MOUNTING 


By filename 


By SCRTCH 
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OPERATOR 
CONTROL 


(1) HORI 
accepted by 
1, 

(2) Mount 
another tape 
and retry with 
R. 
(3) Reject 
with U. 


If VSN/FSN 
is not correct: 


(1) Mount 
another tape 
and retry with 
R. 
(2) Reject 
with U. 


if VSN/FSN 
is not correct: 


(1) Mount 
another tape 
and retry with 
R. 
(2) Reject 
with U. 


Job control 
stream errors 
go to ERROR 
or CANCEL. !f 
incorrect tapes: 


(1) Mount another 
tape and retry 
with R, 

(2) Reject with 
U. 


{1) Mount another 
tape and retry 
with R. 

(2) If unable to 
mount a correct 
tape, reject with 
U to go to CAN- 
CEL or ERROR. 













UP-7629 
Rev. 2 






UNIVAC 9400 


*MVI — Minimum Visual Identification — external label used for reel identification must contain at least the information in this column. 


~. 
NY 
VSN=blank 
FSN=VCHECK | VSN=biank 
FSN=blank VSN=SCRTCH 
FSN=VCHECK | VSN=SCRTCH 
VSN=FSN 
File ID If a specific 
VSN is enter- 
ed, an invalid 
EOF1 label is 
fatal (go to 
ERROR or 
CANCEL). 
* Expiration date} If VSN is 
, SCRTCH or 
WY Creation date: | blank, an 
yyddd £OF1 check 
provides the 
opportunity to 
ignore the error 
(see operator 
control). 
Version number 
Generation 
number 
VOL sequence 
number 
a 


DATA MANAGEMENT SYSTEM 


EOF] required 


EOF1 required 


EOF1 required 


Filename 


Filename 


File serial 
number 


A.2.5. Tape Input Checks (Read Backward) 


JOB CONTROL STATEMENT TAPE LABEL MvI« UPDATE 
LBL VoL CONVENTIONS REQUIRED 
N 


LOGICAL 10CS 
INPUT CHECKS 


EOFI1 label is typed out 
for operator acceptance. 


EQF1 label is typed out. 
FSN in EOF1 label is 
typed out. 


Invalid combination 


EQF1 label is typed out. 
FSN in EOF! is typed 


VSN of VOL card must 
equal FSN of LBL card. 
FSN of EOF] label must 
equal VSN of VOL card. 
EOF) not typed out. 
FSN not typed out. 


If blank, file ID is not 
checked, 

If not blank, must be 
equal to file 1D in EOF1. 
Does not inhibit type-out 


Ignored on input 


If blank, creation date is 
not checked. 

If not blank, must be 
equal to creation date in 
EOF1. 

Inhibits typeout of EOF1. 


If blank, version number 
is not checked, 

If not blank, must be 
equal to version number 
in EOF1, 

Inhibits type-out of EOF. 


Sf blank, generation number 
is not checked, 

If not blank, must be equal 
to generation number in 
EOF1. 

Inhibits type-out of EOF1. 


If blank, 0001 is assumed. 

If not blank, must be equal 

sequence in EQF1. Inhibits 
type-out of EOF]. 
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VOLUME OPERATOR 
MOUNTING CONTROL 


(1) EOF1 
accepted by 

I. 

{2) Reject with 


If FSN of EOF1 
is not acceptable: 


(1) Reject with U. 
{2) Accept with |. 


\f FSN of EOF] 
is not acceptable: 


(1) Reject with U. 
(2) Accept with |. 


If job control stream 
error or incorrect 
tape, go to ERROR 
or CANCEL. 


If unable to ignore 
error, reject with 
U to go to ERROR 
or CANCEL. 
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A.3. 


LABEL PROCESSING FOR DISC FILES 


This part of the appendix relates the parameters of the VOL and LBL Job Control 
statements to the processing of the disc format 1 label on each volume of a sequential, 
direct access, or indexed sequential file. In the following descriptions the words ‘‘new 
and ‘‘old’’ (in parenthesis) refer to indexed sequential files, where a new file is one 
which is being created (loaded) while an old file is one which is undergoing subsequent 
processing. For full descriptions of the Job Control statements, refer to UNIVAC 

OS/4 Job Control Programmer Reference, UP-7793 (current version). 


” 


A.3.1. VOL Statement 


The format for the VOL statement is: 






b OPERATION & 






OPERAND 


Cc 
ae as 
ot "\SCRTCH a 
volno-l 
SCRTCH 


Reference should be made to the UNIVAC OS/4 Job Control Programmer 
Reference, UP-7793 (current version) for a discussion of all of the options 
appearing in the operand field. A blank or missing VOL card is not a valid 
option for disc Data Management files. A discussion of the parameters from the 
VOL card which are pertinent to disc Data Management files follows. (The C, 
Mcc, and CMcc parameters refer only to tape volumes; ‘‘volno-1’’ refers to 
volume serial number 1.) 


When an initial volume serial number (VSN) is supplied on a VOL card, it is checked 
against the standard volume label (VOL1) by job control to ensure that the correct 
volume is mounted. Informational and/or error messages will appear as job control 
type-outs, as appropriate. No further check is made by either DAM or ISAM file 
OPEN routines, since all of these volumes must be online initially. Subsequent 

SAM volumes are checked by comparing the succeeding VSNs which have been 
stored in the VSN List Block with the VOL1 labels on the succeeding volumes, 
Errors result in a DM49 message; see Table E-—1. 


The designation SCRTCH is unusual as a specification for disc Data Management 
files since most users will want to plan on which disc to store their files. 


The SCRTCH parameter receives different treatments, depending on the type of 
access method chosen. 


a For DAM and ISAM files, the action is controlled by the Job Control program. 
Job control searches for a mounted volume which has the designation SCRTCH 
stored in the physical unit block (PUB). If a SCRTCH volume is found, job 
control assigns this device to the user. If no disc PUB containing SCRTCH is 
found, the first unassigned device is chosen. After the operator mounts a volume, 
job control delivers the VSN for checking to the operator. When the operator 
indicates satisfaction with the displayed assignment, the VSN is stored in the 
PUB. 
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mw For SAM files, the job control action for the first volume of a file is the same 
as for DAM and ISAM files. However, logical IOCS performs volume checking 
on this and all subsequent volumes. Whatever is stored in the VSN list block 
from the VOL card is compared to the VOL1 label VSN of the volume mounted. 
Hence, if SCRTCH is given, a match occurs only if the VOL1 label contains 
SCRTCH. Appropriate error action follows any mismatch (see Appendix E.5). 













OPERAND 


Rudedtonerns } { ee eal 
‘file-identifier' 3 V-CHECK 










The file identifier is the only required parameter in the LBL statement for a disc 
file. Any other parameters are optional, as explained in the following paragraphs. 


— may be 44 characters (maximum); uniquely identifies the file 
by name on each volume. If less than 44 characters are speci- 
fied, they are left-justified within a 44-byte field, with spaces 
filled to the right. 


A.3.2. LBL Statement 
The format of the LBL statement is: 
6 OPERATION 5 
POSITIONAL PARAMETER 1 
file-identifier 
ad 


‘file-identifier’ 


For each volume of a new file, the file identifier is written 

by the Allocate function into the key area of the disc physical 
record containing the format 1 label. Before it is written, it is 
checked for uniqueness against the other file identifiers. This 
processing is done by the Disc Space Management routines 
when space is allocated to the file; see Section 5. 


When an OPEN macro instruction is executed for both input 
(old) and output (new) files, the file identifier is used as a 
search argument to retrieve the format 1 label on each volume. 
If the search is unsuccessful on any volume of the file, the 
job step is aborted, or control is passed to the user’s error- 
handling routine. 


— identifies a disc filename that contains embedded blanks. 


PAGE: 


[ ,volume-sequence-number] [,expiration-date] [,creation-date] 
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POSITIONAL PARAMETER 2 


file-serial-number 
or 
VCHECK 


— relates to the file serial number field of the format 1 label 


for each volume of the file. The file serial number can be 

used to uniquely identify a particular copy of a file. It 

should be the volume serial number of the first volume of 

the file, and may be specified either as a one- to six-character 
volume serial number, or as the character string VCHECK. If 

a volume serial number of less than six characters is specified, 
it is right-justified within a six-byte field, with EBCDIC 0’s 
filled to the left. 


For each volume of an output (new) file, one of the following 
applies: 


(1) If a volume serial number was specified, the volume serial 
number of the first volume of the file is inserted into the 
file serial number field of the format 1 label. In addition, 
the volume serial number from the LBL statement is 
checked against that of the first volume, and, if there is a 
discrepancy, a warning message is printed at the console 
while file processing continues. (The check and warning 
messages, if any, are executed only once for the file, not 
for each volume.) 


(2) If the VCHECK parameter was specified, the volume 
serial number of the first volume is inserted into the 
file serial number field of the format 1 label. This 
option thereby allows the file serial number to be used 
without requiring reference to a specific volume serial 
number. 


(3) If the file serial number was not specified, its field in 
the format 1 label will be set to binary 0’s. 


For each volume of an input (old) file, one of the following 
applies: 


(1) If a volume serial number was specified, it is checked 
against the file serial number field of the format 1 label. 
If a discrepancy is found, the job step is aborted or 
control is passed to the user’s error-handling routine. 


(2) If the VCHECK parameter was specified, the volume 
seria] number of the first volume of the file is checked 
against the file serial number field in the format 1 label. 
If a discrepancy is found, the job step is aborted or 
control is passed to the user’s error-handling routine. 


(3) If a file serial number was not specified, the file serial 
number field will not be checked. 
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POSITIONAL PARAMETER 3 


volume-sequence- — may be one or two decimal digits; assures the correct se- 

number quence of the volumes in the file. If only one digit is speci- 
fied, a leading 0 is assumed. The specified value is converted 
to binary and identifies the first volume of the file. It is then 
incremented by one for each succeeding volume of the file. 


For each volume of an output (new) file, the appropriate value 
is inserted in the volume sequence number field of the format 
1 label. If this parameter is not supplied, the volume sequence 
number field of each format 1 label will be set to all binary 
0’s. 


For each volume of an input (old) file, the appropriate value 
is checked against the volume sequence number field of the 
format 1 label. If there is a discrepancy, the job step is 
aborted or control is passed to the user’s error-handling 
routine. If a value is not specified, the volume sequence 
number field will not be checked. 


POSITIONAL PARAMETER 4 


expiration-date or — controls the expiration date; indicates the date when the file 

retention-period can be scratched. If it is specified as a five-digit EBCDIC 
operand, it is interpreted as an expiration date in the yyddd 
format, where yy is the year (00 through 99) and ddd is the 
day (001 through 366). If it is specified as a five-character 
EBCDIC operand Rnnnn, it is interpreted as a retention 
period, where nnnn is the number of days the file is to be 
retained beyond the creation date. In this latter form, the 
number of days is added to the creation date to produce an 
expiration date. (For purposes of this addition, a standard 
year of 365 days is used.) 


For each volume of an output (new) file, the specified or 
computed expiration date is converted to a three-byte binary 
number (in the form ydd) and is placed into the expiration 
date field of the format 1 label. If this positional parameter 
is omitted, the expiration date field will be set to all binary 
0’s. 


This positional parameter is not processed for an input (old) 
file. 
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POSITIONAL PARAMETER 5 


creation-date — specifies a five-digit EBCDIC date, which represents the 
year and day (yyddd) on which the file is considered to 
have been created. 


For each volume of an output (new) file: 


(1) If a creation date is specified, it is converted to a 
three-digit binary number (in the form ydd) and is 
placed in the creation field of the format 1 label. 


(2) If this positional parameter is not supplied, the opera- 
ting system uses the disc Data Management date in 
the job preamble, which is specified either in a SET 
statement for the job, or in a SET command for the 
system. In either case, this date is converted and used 
as described in (1) above. 


For each volume of an input (old) file: 


(1) If a creation date is specified, it is converted to the 
binary form ydd and is checked against the creation 
date field in the format 1 label. If a discrepancy is 
found, the job step is aborted or control is passed to 
the user’s error-handling routine. 


(2) If a creation date is not supplied, the creation date 
field of the format 1 label is not checked. 


The following tables summarize the standard label checks performed for disc files 
and the appropriate error action in each case. 
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7 A.3.3. Disc Label Checking 


JOB CONTROL 
FIELD (STATEMENT) 


CONTENTS 


Blank (or no 
VOL card) 


Volume serial number 
(VOL) 


SCRTCH 


nnonnann 


Blank (or no 
LBL card) 


File identifier (LBL) 


Key (up to 44 


characters) 
we 
File serial number 
(LBL) 
VCHECK 
annnnn 
| Volume sequence 
number (LBL) 
Expiration date 
Creation date (LBL) 
a 


ACTION 


(Invalid specification) 


Compared to VSN in 
VOL1 label of volume. 


(Invalid specification) 


VTOC is searched for 
a format 1 label with 
given key. 


FSN of format 1 label 
is compared to VSN of 
first volume. 


Compared to FSN of 
format 1 label. 


None 


Volume sequence 
number of format 1 
label compared to 
sum of nnnn and 
relative position 
of volume. 


Compared to creation 


date in format 1 label. 





*Refer to Appendix E for full explanation of these error codes. 
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ERROR ACTION* 


DM48 message. Enter ERROR= 
symbol if present; otherwise 


For direct access and indexed 
sequential files: 


JC02 job control message. 


For sequential files: 


JCO2 job contro! message for 
first volume. 


DM4N VOL1 ERR message for 
subsequent volumes. 


In either case, operator can 
retry or CANCEL. 


DM4F message. Enter ERROR 
=symbol if present; otherwise 
CANCEL. 


DM4A message. Enter ERROR= 
symbol if present; otherwise 
CANCEL. 


DM4N message. Enter ERROR= 
symbol if present; otherwise 
CANCEL. 


ee ee ee 


DM4N message. Enter ERROR= 
symbol if present; otherwise 
CANCEL. 


None 


DM4N message. Enter ERROR= 
symbol if present; otherwise 


DM4N message. Enier ERROR= 
symbol if present; otherwise 
CANCEL. 
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JOB CONTROL CONTENTS ACTION ERROR ACTION* 
FIELD (STATEMENT) 


Volume serial number Blank (Invalid specification) 
(VOL) (or no VOL 
card) 


SCRTCH See text, A.3.1. 


nannnn Compared to VSN in 
VOL1 label of volume. 


File identifier (LBL) Blank (or no (Invalid specification) 
LBL card) 


Key (up to 44 VTOC is searched for 
characters) a format 1 label with 
given key. 


File serial number None 
(LBL) 
VCHECK VSN of initial volume 
is placed in FSN field 
of format 1 label. 


nnnannn 1. VSN of initial volume 
is placed in FSN field 
of format 1 label. 


- Onnnnn is compared 
to VSN of initial vol- 
ume. 


*Refer to Appendix E for full explanation of these error codes, 


DM48 message. Enter ERROR= 
symbol if present; otherwise 
CANCEL. 


For direct access and indexed 
sequential files: 


JCQ2 job control message. 


For sequential files: 


3C02 job. control message for 
first volume. 


DM4N VOL1 ERR message for 
subsequent volumes. 


In either case, operator can 
retry or CANCEL. 


DM4F message. Enter ERROR= 
symbol if present; otherwise 
CANCEL. 


DM4A message. Enter ERROR= 
symbol if present; otherwise 
CANCEL. 


DM4N message. Processing 
continues. 
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Volume sequence 
number (LBL) 


Expiration date (LBL) 


Creation date (LBL) 


DATA MANAGEMENT SYSTEM 





CONTENTS 





None 


Volume sequence num- 
ber of format 1 label is 
set to sum of nnnn and 
relative position of 
volume. 


None 


Format 1 field set to 
sum of nnnn and crea- 
tion date; correcting 
for year changes. 


Format 1 field set to 
specified date (in 
binary). 


Format 1 field set to 
date in preamble. 


Format 1 field set to 
specified date (in 
binary). 


* — Refer to Appendix E for full explanation of these error codes. 
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APPENDIX B. COMPATIBLE 


ed 
B.1. GENERAL 
To help maximize the compatibility of UNIVAC OS/4 Operating System (OS/4) 
source programs with those of comparable systems, each of the DTF declar- 
ative macro instructions accepts as equivalent the comparable keyword para- 
meters listed in the following tables, All other keyword parameters are 
identical among systems. 
B.2. DITFMT PARAMETERS 
UNIVAC OS/4 COMPARABLE KEYWORD 
DTFMT KEYWORD PARAMETERS 
PARAMETERS 
BLKSIZE Block length 
EOFADDR User’s end-of-file address 
FILABL Indicates type of labels in the file 
ee” 
1OAREAI1 Name of user's first |/O area 
IOAREA2 Name of user’s second 1/O area 
1OREG 1/0 pointer register 
TYPEFLE Specifies whether file is to be used for 
input, output, or both 
CKPTREC Indicates presence of checkpoint record 
ERROPT Specifies user’s error routine resulting 
from parity errors 
RECFORM Record format 
RECSIZE Record length 
TPMARK Indicates tapemark is written as first 
record following labels 
LABADDR Name of user’s label processing routine 
VARBLD Specifies a user register in which logical 
1OCS places the variable length record 
residual space 
Specifies a user workarea in which records 
are processed 
NS 





Table B-1. Compatible DTFMT Keyword Parameters 
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The following keyword parameters are found in comparable systems, but are 
ignored in UNIVAC OS/4 source programs: 


DEVADDR CRDT 
DEVA XPDT 
HDRINFO GENO 
FLID VOLN 
MODNAME 


B.3. DTFSD PARAMETERS 


UNIVAC 0S/4 COMPARABLE KEYWORD 
DTFSD KEYWORD PARAMETERS 

PARAMETERS 
BLKSIZE 
CONTROL 
EOFADDR 
ERROPT 
lOAREAI1 
IOAREA2 
IOREG 
LABADDR 
RECFORM 
RECSIZE 
TYPEFLE 
UPDATE 


VARBLD 


WORKA 








NOTEPNT 
REWIND 
SEPASMB 
WLRERR 


Block length 

Control entry 

User's end-of-file address 

Unique file error address 

Name of user’s first input/output area 
Name of user’s second input/output area 
1/0 pointer register 

User label processing address 

Record format 


Logical record length 


Type of retrieval functions 


Input file update 


Variable length record residual space 
register 


Work area to be used for processing data 


Table B-2, Compatible DTFSD Keyword Parameters 
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ae The following keyword parameters are found in comparable systems, but are 
Na ignored in UNIVAC OS/4 source programs: 
DELETFL MODNAME SEPASMB 
DEVADDR NOTEPNT WLRERR 
B.4. DTFCD PARAMETERS 
UNIVAC 0S/4 COMPARABLE KEYWORD 
DTFCD KEYWORD PARAMETERS 
PARAMETERS 
BLKSIZE Block length 
CONTROL 
CNTL | Control entry 
EOFADDR User’s end-of-file address 
1OAREA1 Name of user’s first input/output area 
IOAREA2 Name of user’s alternate input/output 
area 
IOREG 1/O pointer register 
OUBLKSZ Output blocksize for combined files 
CRDERR Hole count error recovery 
ad RECFORM Record format 


RECSIZE Record size register for undefined 
records 


Type of file 


TYPEFLE 
TYPF 


WORKA Specifies a user workarea for processing 


records 


Table B-3. Compatible DTFCD Keyword Parameters 
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The following keyword parameters are found in comparable systems, but are 


ignored in UNIVAC OS/4 source programs: “ 
DEVADDR SEPASMB MODNAME 
DEVICE 


B.5. DTFPR PARAMETERS 


UNIVAC 08/4 COMPARABLE KEYWORD 
DTFPR KEYWORD PARAMETERS 
PARAMETERS 


BLKSIZE Block fength 


Control entry 


CONTROL 
CNTL 


JOAREA1 Name of user’s first input/output area 


IOAREA2 Name of user’s alternate input/output 
area 





IOREG 1/O pointer register 
RECFORM Record format 
RECSIZE Record size register for undefined records 
WORKA Specifies a user work area for processing 
records 
— 
Table B—4. Compatible DTFPR Keyword Parameters 
‘The following keyword parameters are found in comparable systems, but are 
ignored in UNIVAC OS/4 source programs: 
PRINTOV DEVADDR DEVICE 
SEPASM MODNAME STLIST 
ucs 
B.6. DTFDA PARAMETERS 
UNIVAC 0S/4 COMPARABLE KEYWORD 
DTFDA KEYWORD PARAMETERS 
PARAMETERS 
BLKSIZE 1/0 area size 
CONTROL Offline seek 
JOAREAI Name of user’s 1/0 area 
LABADDR Name of user’s label processing 
routine 
RECFORM Record format 
RECSIZE Record length 


TYPEFLE Type of file 





Table B—5. Compatible DT FDA Keyword Parameters 
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The following keyword parameters are found in comparable systems, but are 
ignored in UNIVAC OS/4 source programs: 


Record format 
Record size 
1/0 pointer register 


Work areas to be used for sequential 
processing 


Type of retrievat/update functions 


The following keyword parameters are found in comparable systems, but are 





SEPASMB 


Block length 
Indicates the DJ$CTL module is needed 
Name of user's end-of-file routine 


Name of user’s first 1/O area 


Name of user’s second I/O area 


Indicates user’s 1/O register 
Record format 

Indicates user’s RCSZ register 
Indicates which rows to be sensed 


Specifies a user work area 


Ne 
DEVADDR 
MODNAME 
SEPASMB 
B.7. DTFIS PARAMETERS 
UNIVAC 0OS/4 COMPARABLE KEYWORD 
DTFIS KEYWORD PARAMETERS 
PARAMETERS 
RECFORM 
RECSIZE 
IOREG 
WORKS 
TYPEFLE 
Table B—6. Compatible DTFIS Keyword Parameters 
ignored in UNIVAC OS/4 source programs: 
Ne 
DSKXTNT INDSKIP 
HINDEX MODNAME 
B.8. DTFOR PARAMETERS 
UNIVAC OS/4 COMPARABLE KEYWORD 
DTFOR KEYWORD PARAMETERS 
PARAMETERS 
BLKSIZE 
CONTROL 
EOFADDR 
IOAREA1 
IOAREA2 
!OREG 
RECFORM 
RECSIZE 
MRST 
WORKA 
Ne 


Table B—7. Compatible DTFOR Keyword Parame ters 
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The following keyword parameters are found in comparable systems, but are 


ignored in UNIVAC OS/4 source programs: ard 
BLKFAC DEVA,DEVADDR MODNAME 
CHNL DEVICE SEPASMB 


COREXIT HEADER 
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APPENDIX C. DATA MANAGEMENT 
VO MODULES 
C.1. GENERAL 
The automatic-include feature of the Linkage Editor calls in the required I/O object 
modules from the Systems Reserve Library, as dictated by the EXTRN directives 
generated by each DTF call. 
The various I/O module names associated with each DTF are given in the following 
sections. 
C.2. DTFMT I/O MODULES 
WN 
MODULE NAME COMMENTS 
DS$PTA Output file, unblocked records, no work area specified 
DS$GTA Input file, unblocked records, no work area specified 
DS$PTB Output file, unblocked records, work area specified 
DS$GTB Input file, unblocked records, work area specified 
DS$PTC Output file, blocked records, no work area specified 
DS$GTC Input file, blocked records, no work area specified 
DS$PTD Output file, blocked records, work area specified 
DS$GTD Input file, blocked records, work area specified 
DS$PTE May be used with any of the above output file combinations 
DS$GTE May be used with any of the above input file combinations 
DT$GTG Required when processing input files backward 
DSS$ISS Required with any of the above 
DT$WKO Required with any of the above output file combinations 
DT$WKI Required with any of the above input file combinations, 
except read backward 

DT$WKB Required when processing input files backward 
DS$MVR Required with any file using a work area 
DS$TNC Required with blocked output files 
DS$RSE Required with blocked input files 
DT$CTL Required with any file using the CNTRL macro instruction 
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C.3. DTFSD I/O MODULES 


oe 
MODULE NAME COMMENTS 
DS$PTA Output file, unblocked records, no work area specified 
DS$GTA Input file, unblocked records, no work area specified 
DS$PTB Output file, unblocked records, work area specified 
DS$GTB Input file, unblocked records, work area specified 
DS$PTC Output file, blocked records, no work area specified 
DS$GTC Input file, blocked records, no work area specified 
DS$PTD Output file, blocked records, work area specified 
DS$GTD Input file, blocked records, work area specified 
DS$PTE May be used with any of the above output file combinations 
DS$GTE May be used with any of the above input file combinations 
DS$ISS Required with any of the above 
DS$WCO Required with any of the above output file combinations 
DS$WCI Required with any of the above input file combinations and 

including the updating function 
DS$MVR Required with any file using a work area 
DS$TNC Required with blocked output files 
DS$RSE Required with blocked input files 
DS$CNT Required with any file using the CNTRL macro instruction, 

including INPUT with UPDT specified 
DS$GTF Input file, with UPDT specified 
DS$PTF Input file, with UPDT specified acid 
DX$ISS Input file, with UPDT specified 
DS$RLU Input file, blocked records, with UPDT specified 
DS$ISU Input file, with UPDT specified 


C.4. DTFCD 1/0 MODULES 


MODULE NAME COMMENTS 

—> DQS$GET Combined file, input module 
DQ$PUT Combined file, output module 
DR$GET Input file (card reader only) 
DWS$10E Output file, one I/O area but no work area specified 
DWS$I1LE Output file, one I/O area with a work area specified 
DW$20E Output file, two I/O areas but no work area specified 
DW$21E Output file, two I/O areas with a work area specified 
DW$62E May be used with any of the above output file combinations 
DWS$CHK Required with any of the above 
DWSCNT Required with any file using the CNTRL macro instruction 
DW$RTY Required with any file when PUNR is specified 
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DTFPR I/O MODULES 


MODULE NAME 


DP$10E 
DP$11E 
DP$20E 
DP$21E 
DP$62E 
DP$CHK 
DP$CNT 
DP$PRT 


DTFDA I/O MODULES 
MODULE NAME 


DD$RD 
DD$WR 


DDS$FW 


DD$SK 
DD$CT 
DD$ID 

DD$RL 
DD$AC 
DD$BC 
DD$WT 
DDSAW 


DD$RW 
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COMMENTS 


Output file, one I/O area but no work area specified 


Output file, one I/O area with a work area specified 


Output file, two I/O areas but no work area specified 


Output file, two I/O areas with a work area specified 


May be used with any of the above output file combinations 


Required with any of the above 


Required with any file using the CNTRL macro instructions 


Required with any file when PRTOV is specified 


COMMENTS 


Required with READ macro instructions 
Required with data WRITE macro instructions (KEY or ID 


specified) 


Required with format WRITE macro instructions (AFTER or 


RZERO specified) 
Required with any file 
Required with any file 
Required with any file 
Required with any file 
Required with any file 
Required with any file 
Required with any file 
Required with any file 
addressing) 


Required with any file 
addressing) 


using the CNTRL macro instruction 


when RELATIVE is not specified 
when RELATIVE is specified 
when AFTER is not specified 
when AFTER is specified 


when IDLOC is specified (absolute 


when IDLOC is specified (relative 
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C.7, DTFIS 1/0 MODULES 


-, 

MODULE NAME COMMENTS 

DUSADD Required with IOROUT = ADD or IOROUT = ADDRTR speci- 
fied 

DU$SABLK Required with IOROUT = ADD or IOROUT = ADDRTR and 
RCFM = FIXBLK specified 

DUSAUNB Required with IOROUT = ADD or IOROUT = ADDRTR and 
RCFM = FIXUNB specified 

DU$AMIO Required with IOROUT = ADD or IOROUT = ADDRTR and 
IOSIZE specified 

DU$LOAD Required with IOROUT = LOAD or RELOAD specified 

DU$RRAN Required with IOROUT = RETRVE and TYPE = RANDOM 
specified : 

DU$RWRT Required with IOROUT = RETRVE and TYPE = RANDOM 
specified 

DU$RESL Required with IOROUT = RETRVE and TYPE = SEQNTL 
specified 

DU$RGET Required with IOROUT = RETRVE and TYPE = SEQNTL 
specified 

DU$RPUT Required with IOROUT = RETRVE and TYPE = SEQNTL 
specified 

DUS$RSEQ Required with IOROUT = RETRVE and TYPE = SEQNTL 
specified 

DUSWTF Required with (OROUT = ADD or IOROUT = ADDRTR) or taste) 
(IOROUT = RETRVE and TYPE = RANDOM) specified 

DU$XRCI Required with (IOROUT = ADD or IOROUT = ADDRTR) or 
(IOROUT = RETRVE and TYPE = RANDOM) and (INDAREA 
and INDSIZE) specified 

C.8. DTFOR 1/0 MODULES 

MODULE NAME COMMENTS 

DJ$GET Input file 

DJ$CTL Required with any file using the CNTRL macro instruction 

DJSWCK Required with any of the above 

C.9. DTFPT I/O MODULES 

MODULE NAME COMMENTS 

DV$GET Input file (reader) 

DV$ISS Input file, with SCAN specified and 1 I/O area 

DV$SCN Input file, with FTRANS, LTRANS, and SCAN specified 

DV$TRAN Required if TRANS specified for output files, or FTRANS 
and LTRANS specified for input files 

—> DV$WCI Required for input files 

DS$MVR Required with any file using a work area 

DV$PUT Output file (punch) J 

DV$SHFT Output file, with TRANS, FSCAN, or LSCAN specified i 


DV$WCO Required for output files 
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APPENDIX D. DATA MANAGEMENT 
TRANSIENT ROUTINES 


The Data Management transient routines are stored on the systems device as reloca- 
table modules, which are located and brought into the transient area by the supervisor 
when an OPEN, CLOSE, or FEOV macro instruction is encountered in the problem 
program. The various transient routine names associated with each DTF follow: 


D.2. DITFMT TRANSIENT ROUTINE NAMES 


The OPEN transient routine names are: 


$Y$F6600 — 
$Y$F660A — 
$Y$F6601 — 
$Y$F6602 — 
$Y$F 6603 — 
$Y$F 6604 — 
$Y$F6605 — 
$Y$F 6606 — 
$Y$F6607 — 
$Y$F 6608 — 
$Y$F 6609 — 


Input/output common 
Input/output common 


Input first overlay 
Input second overlay 
Input third overlay 
Input fourth overlay 
Output first overlay 
Output second overlay 
Output third overlay 
Input fifth overlay 
Input sixth overlay 


The CLOSE transient routine names are: 


SY$F6800 — 
$YS$F6801 — 
SY$F6802 — 
SY$F6803 — 
SY$F6804 — 
$SY$F6805 — 
$YSF680A — 
SY$F6806 — 


Input/output common 
Input first overlay 
Input second overlay 
Input third overlay 
Input fourth overlay 
Output first overlay 
Output second overlay 
Output third overlay 


The FEOV common transient routine name is $Y$F6CO00. 


D.3. DTFSD TRANSIENT ROUTINE NAMES 


The OPEN transient routine names are: 


$Y$S6600 — 
$Y$S6601 — 
$Y$S6602 — 
$Y$S6603 — 
$Y$S6604 — 
$Y$S6605 — 
$Y$S6606 — 
$Y$S6607 — 


Input/output common (and complete the DTF) 
Input/output (and complete the DTF) 
Input/output label checking 

Format 1 label processing 

Format 1 and 3 label processing 

User header label processing 

Cleanup and input file initial reads 

Special format 1 and format 3 label reads 


The CLOSE transient routine names are: 


$Y$S6800 — 
$Y$S6801 — 
$Y$S6802 — 


_ 
Neer’ 


Input/output common 
First overlay — user trailer labels 
Second overlay — multivolume files 


The FEOV common transient routine name is $Y$S6CO0. 
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DTFCD TRANSIENT ROUTINE NAMES 


The OPEN transient routine names are: 


$Y$R6600 (READER) 
$Y$W6600 (PUNCH) 
$Y$Q6600 (READ/PUNCH) 


The CLOSE transient routine names are: 


$Y$R6800 (READER) 

$Y $W6800 (PUNCH) 

$Y$Q6800 (READ/PUNCH) 

DTFPR TRANSIENT ROUTINE NAMES 

The OPEN transient routine name is $Y$P6600, 


The CLOSE transient routine name is $Y$P6800, 


DTFDA TRANSIENT ROUTINE NAMES 
The OPEN transient routine names are: 


$Y$G6600 — first overlay 
$Y$G6601 — second overlay 
$Y$G6602 — third overlay 
$Y$G6603 — fourth overlay 
$Y$G6604 — fifth overlay 


The CLOSE transient routine name is $Y$G6800. 


DTFIS TRANSIENT ROUTINE NAMES 
The OPEN transient routine names are: 


$Y$Y6600 — first overlay 
$Y$Y6601 — second overlay 
$Y$Y6602 — third overlay 
$Y$Y6603 — fourth overlay 
SY$Y6604 — fifth overlay 


The CLOSE transient routine names are: 


$Y$Y6800 — first overlay 
$Y$Y6801 — second overlay 


For file loading routines, the transient routine names are: 


$Y$T9COO — SETFL (set file load) 
$Y$T9CO1 — second overlay 
$Y$TAO000 — ENDFL (end file load) 
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A, 


For sequential processing, the SETL transient routine name is $Y$T9EOO. 
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DTFOR TRANSIENT ROUTINE NAMES 

The OPEN transient routine names are: 
$Y $J6600 

The CLOSE transient routine names are: 
$Y $J6 800 

DTFPT TRANSIENT ROUTINE NAMES 

The OPEN transient routine names are: 
$Y$V6600 

The CLOSE transient routine names are: 


$Y$V6800 
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APPENDIX E. DATA 
MANAGEMENT 
MESSAGES 


CONSOLE MESSAGES 


Data Management operator communication is accomplished by means of a series of 
console messages. These messages are used to describe an error condition or an 
informational function. The following standard prefix is typed out for all Data Manage- 
ment messages. This prefix can appear by itself or in combination with an informational 
type message. When the error. code appears alone, it denotes the reason for the message. 
When the error code occurs as a message prefix for an informational type message, the 
error code position (e) is usually blank. 


DM4e uuu filename 


where: e — represents an alphanumeric character code that specifies the error 
that has occurred. These error codes are defined in the Data Manage- 
ment portion of the Standard Equate macro instruction, STDEQU, 
and are listed in Table E-1. 


uuu -— is the device identification code. 
filename — is the label assigned to the DTF macro instruction. 


Refer to UNIVAC 9400 System Operations Handbook Operator Reference, UP-7871 
(current version), for explanation and action of all console messages. 


Messages are possible from all OPEN and CLOSE transient modules. There is no 

reply to the message when the prefix appears alone. If the user supplied an ERROR= 
symbol address in the DTF macro instruction, control is passed to that point; otherwise 
the job step is cancelled. However, note exceptions to this action as indicated in 
Notes 2 and 4 in Table E-1. 
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STANDARD 
EQUATE 
VALUE 


DISEO1 OPENing an already OPENed file 


DISE02° CLOSEing an already CLOSEd file 


DISE02A Lockout systems error 
DI$E03 Unreadable or missing File Control Block) 


DISE05 Block size or KEYLOC specification error 
DISE06 OTF specification error 
DI$E07 Required Data Management module missing 


DI$ E09 Extent table full DA,SD, 


DISE11 No PUB allocated, and for SAM file no 
OPTION=YES specified. Also for disc, 
missing VQL card or blank VSN field on 
VOL card 

DI$E13 VOL1 or EOF1 label missing, unreadable, ae 
or incorrect 

DI$E15 Format 1 or HDR1 label not found or MT,SD 
unreadable 


DA,IS 
DI$E16 Tape standard Jabel (user or system) 
DI$E71 


unreadable 
DI$E17 Format 2 or 3 label not found or unreadable $D,DA, 


DI$E19 Format 4 label not found or unreadable maa” 
DI$E20 Error in reading user header or trailer label MT,SO, aaa * 
DI$E21 Missing file ID in file control block $D,DA, ia 


DI$E 23 1/O error (hardware) when reading or MT, sD MT,SD,CD, 
writing data PR,DA,IS 


DI$E25 Accessing a file which is not OPEN 

DI$E27 VSN list block error te 

DI$E65 Invalid extent specification for ISAM 

DI$E29 Initial VSNZFSN from LBL card (tape), MT,IS 
or parameter 2 of LFD card not IS for ISAM 

DI$E31 Error in writing a system standard label MT,SD, 
block DA,IS 

DI$E33 Error in writing a user tabel block MT,SD, 


Table E-]. Explanation of Error Codes 
(Part IT of 2) 


APPLICATION FILE TYPE 


PROCESSING |CLOSE 






REASON FOR ERROR 








PR: ae CD, 


All 
















Format 1 labei for the file indicates 
zero extents on current file 


SA,DA, 


Baa 





Da oOo 
ay]* 


MT,SD 





1S,DA 


MT,SD 





MT,SD, 


MT,SD 


U4 — 
a a? m 
On ° 
2 < 
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ERROR | STANDARD APPLICATION FILE TYPE 








REASON FOR ERROR 
































































posts () 
PROCESSING CLOSE 
FEOV 
DI$E37 Standard label field incorrect, as speci- MT,SO, 
fied for checking by job control stream DA,IS 
DISE39 1/0 timits-check failure (ERRBYTE,IDLOC, | All 
10A1, 10A2, IOAREAL, IOAREAR, IOAREAS 
ie DI$E41 Invalid imperative macro instruction a) SD, DA, IS, OR <f—= 
DISE43 WAITF macro instruction not issued follows DA 
ing a READ or WRITE macro instruction 
DISE45 Missing or inaccessible transient overlay, or 
common code index error 
T DI$E49 Time limit reached when processing user MT,SD, MT,SD 
labels, user extents, or searching for DA 
tape marks on tape 
U DI$E51 Keylength incorrectly specified (less DA,IS 
than 3 or greater than 255), or missing 
when required 
DI$E53 Block length incorrect all MT, PT <_ 
DI$ESS Checkpoint numbers on tape do not match MT 
DIS £67 Too many cylinder overflow tracks on disc 
DI$E57 Block number or data block count error 
‘ Y DISES5 Invalid or inconsistent device (DVC 
sia sectghient aN ce 
foes 
DISE61 Resident cylinder index cannot be supported Ca aan ee 
¢ DISE63 Expanded |/O area cannot be supported IS 
DISE69 Exhausted last extent of last volume SD 
i DI$E73 End of record character detected (INPUT) PT 
Low tape condition (QUTPUT) ‘ 
+ DI$E74 Invalid character control (CTLCHR) Pf ork] 
DI$E75 Unique unit error co = 
DI$E77 Alternate track disallows add 1S | | 
DI$E78 Input and/or output translation tables cD : 
not present 
NOTES:(1) Check job stream for a missing or incorrect LFD card (fitename is seven characters maximum). 
(2) For card reader, punch, or printer only, block size parameter is adjusted to show maximum; 
and processing continues. 
® Check job stream for missing DVC card or incorrect or missing VOL card. 
For disc output (new) files, when FSN or LBL card does not equal the initial VSN, this 
message ts informational and program continues, 
In volume swap Situations for tape (MT) and disc (SD) files, some errors listed as occurring 
during OPEN, CLOSE, or FEQV can also occur during GET or PUT processing. 


Table E-1. Explanation of Error Codes 
(Part 2 of 2) 


a 
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eel 
F.1. GENERAL 
Error conditions encountered in the processing of indexed sequential files can 
be placed into three categories: 
(1) Initialization errors detected during the execution of an OPEN macro in- 
struction, which are usually unrecoverable; 
(2) Recoverable errors detected other than during the execution of an OPEN 
instruction; and 
ae, (3) Unrecoverable errors detected other than during the execution of an 


OPEN instruction. 


Errors detected during the execution of the OPEN macro instruction cause a 
message to be printed at the operator’s console, which indicates in which 
file and logical unit the error occurred and the nature of the error. If the error 
is unrecoverable, the job step is aborted or control is passed to the user’s 
error routine; if it is recoverable, the job step continues normally. 


In the case of those errors detected other than during the execution of an 
OPEN macro instruction, the unrecoverable errors generally cause either 
an exit to the user’s error routine or an abort (if no error routine was 
specified), while the recoverable errors are indicated in a field (in the 
DTFIS-generated file table) labeled filenameC (refer to 4.2.2), with the 
control returning to the normal place in the user’s program. 
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ERROR FIELD (filenameC) 


Within the table generated by the DTFIS declarative macro instruction for the file is 

a two-byte field which is used to convey error and status information to the user’s 
program. This two-byte error field is addressed by the concatenated label filenameC. 
For example, for files labeled EMPLUST, OMST, and NC, this field in each file would 
be addressed as EMPLUSTC, OMSTC, and NCC, respectively. (See 4.2.2 for a further 
description of the use of this method of labeling.) 


Unless otherwise noted, control is always returned to the next instruction following 
the macro instruction in which the error or condition was detected. In all cases, 
register 1 contains the address of the DTFIS-generated table, registers 2 through 13 
remain as the user set them, and register 14 contains the address of the normal return 
address in the user program. Therefore, the error field filenameC should be checked 
after each macro instruction, except OPEN and CLOSE. 


Byte 1 of the error field contains indicators for various error conditions. The type of 
error indicator is based on the type of file processing being performed. The error 
field as set during each type of file processing is described in the following para- 
graphs. 


Unrecoverable Error Indicators 


In byte 1 of the error field, filenameC, two bits, 0 and 1, are used in the same way 
for all types of processing. Bit 0 indicates an unrecoverable device error, and bit 
1 is not used. 


Bit 0 of filename C is set when byte 2 of the error field is other than zero. Except 


as noted, byte 2 (filenameC+1) reflects byte 1 of the transmission bytes in the 
CCB at the time of the error. 


a Byte 1, Bit 0 — Unrecoverable Device Error 


If an unrecoverable device error has been detected during the execution of a 
macro instruction, an indicator in the DTFIS-generated table marking the file 
as open is turned off. Further access to the file results in a file-not-open error 
condition. 


ws Byte 1, Bit 1 


This bit is not used by the file processing functions of Data Management. 


a Byte 2 


The entire byte is used to reflect the first transmission byte in the CCB as set 
by the I/O interrupt processing routines and error processing job. Additional 
settings of byte 2 are made if errors occur when records are being inserted in 

a file (see F.2.3). 


Loading or Extending a File 


When IOROUT=LOAD (or RELOAD) is specified, a new file is to be created or re- 
created, or an old file is to be extended as described in 4.2.3.2. The ENDFL macro 
instruction sets only bit 0 of byte 1 of the error field. In addition to bit 0, the SETFL 
macro instruction sets bits 2 and 3; the WRITE NEWKEY sets bits 2, 5, and 6. The 
following paragraphs describe the conditions for setting these bits. Figure F—1 
summarizes the bit settings for errors which occur during the file loading or extend- 
ing. 
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m Bit 2 — Prime Data Area Full 


This bit can be set for an old file by the SETFL macro instruction and for an old 
or new file by the WRITE NEWKEY macro instruction when the prime data area is 
full, 


When the SETFL macro instruction attempts to extend an old file, and the prime 
data is already full, an indicator in the DTFIS-generated table marking the file 
open is reset. Further access to the file results in a fileenot-open condition. 


If a record loaded into the file by the WRITE NEWKEY macro instruction fills 
the prime data area, no further records may be loaded. When control returns to 
the user program, the four-byte filenameP field in the DTFIS-generated table 
contains a count of the number of logical records in the prime data area, and 
filenameH contains the disc address (in the form MBBCCHHR) of the logical 
record just written. 


If a file is to be accepted as loaded, the file loading process may be terminated 
normally by executing an ENDFL macro instruction. When executed successfully, 
ENDFL resets filenameC. 


If, however, the file is not accepted as loaded, the user program should be termin- 
ated if bit 2 of filenameC is on. The entire loading process beginning with the 
initial load must be repeated after this file is scratched, and the necessary amount 
of disc space must be allocated. 


w Bit 3 — Index Area Too Small 


When the SETFL macro instruction computes the space required for the higher 
level cylinder and master indexes, based on the file key size and the number of 
prime data cylinders, and the extent (first extent on the first volume) is not large 
enough, this bit is set. This is an unrecoverable error, and the user program must 
be terminated so that additional index space can be allocated to the file. 


An indicator in the DTFIS-generated table marking the file as open is reset. If 
another macro instruction is executed for the file, control is transferred to the 
user’s error routine. If an error routine was not specified, the job step is aborted. 


m Bit 4 — Unused 


mw Bit 5 — Duplicate Key 


When the WRITE NEWKEY macro instruction attempts to load the current logical 
record from the area specified by WORKL and the key of the current logical record 
duplicates a key already in the file, this bit is set. The current record is not placed 
in the file, but normal processing of the file can continue with other logical records. 


m Bit 6 — Key Out of Sequence 


When the WRITE NEWKEY macro instruction attempts to load the current logical 
record from the area specified by WORKL and the key of the current logical record 
is less than the key of the preceding logical record, this bit is set. The current 
record is not placed in the file, but normal processing of the file can continue 
with another logical record. 


a Bit 7 — Unused 
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Figure F—1. Error Field Bit Settings — File Loading and Extending 






F.2.3. Inserting Records in a File 


When IOROUT=ADD (or ADDRTR) is specified, the WRITE NEWKEY and WAITF 
macro instructions are used to insert records in a file. The WRITE NEWKEY macro 
instruction sets only bit 0 in byte 1 of the error field for an unrecoverable device 
error as described in F.2. Byte 2 of the error field reflects the first transmission 

byte in the CCB at the time of the error. Additional settings of byte 2 may be made 
by the WAITF macro instruction. Figure F—2 summarizes all bit settings. An 
explanation of the bit settings in the error field are given in the following paragraphs. 


a Bit 0 — Unrecoverable Device Error. 


If the WAITF macro instruction finds an unrecognizable track index entry type, 
byte 1 is set to X'80' and byte 2 is set to X'01'. If the WAITF macro instruction 
finds an extent table or last prime data ID anomaly, byte 1 is set to X'80! and 
byte 2 is set to X'02'. In either case an indicator in the DTFIS-generated table 
marking the file as open is turned off. Further attempts to access the file result 
in a file-not-open error condition. 


w Bits 1 through 4 — Unused 


w Bit 5 — Duplicate Key 


When the WAITF macro instruction attempts to insert the current logical record 
from the area specified by WORKL and the key of the current logical record 
duplicates a key already in the file, this bit is set. The current record is not 
placed in the file, but normal processing of the file can continue with another 
logical record. 


wm Bit 6 — Overflow Area Full 


When the WAITF macro instruction, issued following a WRITE NEWKEY macro 
instruction, attempts to insert the current logical record from the area specified 
by WORKL and no overflow area is available to hold the logical record displaced 
from the prime data tracks, this bit is set. The record is not inserted, but normal 
processing of the file can continue. 


w Bit 7 — Unused 
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Figure F-2. Error Field Bit Settings — Inserting Records 


F.2.4. Random Processing of Records 


When IOROUT=RETRVE (or ADDRTR) and TYPE=RANDOM (or RANSEQ) are 
specified so that records may be retrieved in random order for processing, the 
READ KEY macro instruction and WAITF macro instruction that must follow set 
the error field. The WRITE KEY macro instruction and the WAITF macro instruction 
that must follow set only bit 0 of byte 1 of the error field. Figure F~3 summarizes 
all bit settings. 


a Bit 2 — Unused 


m Bit 3 — No Record Found 


When a READ KEY macro instruction or the following WAITF macro instruction 
is executed and no record with a key equal to the key argument value is found 

in the file, this bit is set. A successful WAITF macro instruction does not pre- 
clude further processing of the file and may be followed by a valid macro instruc- 
tion other than a WRITE KEY macro instruction. However, if bit 3 was set when 
Nene!’ the READ KEY macro instruction was executed, a WAITF macro instruction must 
be issued before the file can be processed further. Bit 3 remains set, but any 
valid macro instruction other than a WRITE KEY may now be issued. 


a Bits 4 through 6 — Unused 


m Bit 7 — Record Retrieval from Overflow 


If the logical record retrieved was taken from an overflow area, this bit is set 
during the execution of the WAITF macro instruction which follows a READ 
KEY macro instruction. Processing of the record and file proceeds normally. 


= 
retrve | ranoom | reankey |x! | |x| [| | | 


appatr | ranseg | MATE UXT | UXT [| 


powarewey [xt | det | 
p owarte XE TE TT 





*Set by READ KEY or the WAITF macro instruction following the READ KEY macro 
instruction. 


Figure F-3. Error Field Bit Settings — Random Processing 
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Sequential Retrieval of Records ‘ 


When IOROUT=RETRVE (or ADDRTR) and TYPE=SEQNTL (or RANSEQ) are 


se 


specified, records can be retrieved from a file in sequential order using the four 
macro instructions SETL, GET, PUT, and ESETL. Normally, the PUT and ESETL 
macro instructions set only bit 0 of byte 1 in the error field. Additional bits may be 
set by the SETL or GET macro instructions. Figure F—4 summarizes the bit settings 
for errors which occur during the sequential retrieval of records. 


Bit 2 — End of File 


If a GET macro instruction attempts to make the next record available to the 
user program and an end-of-file indication is detected, this bit is set. The 
next macro instruction for the file must then be an ESETL macro instruction 
which terminates the retrieval sequence. 


If the user has equated a label to the EOFA keyword parameter in the DTFIS 
declarative macro instruction, control is transferred to the user routine; other- 
wise, control returns to the normal place. 


Bit 3 — No Record Found 


1. If the second parameter of a SETL macro instruction is KEY or GKEY, it 
is possible that no record with a key equal to or greater than the key argu- 
ment value could be found in the file. This does not preclude further processing 
of the file; another SETL macro instruction can be attempted, a READ KEY 
macro instruction can be executed if DTFIS supports random retrieval, or a 
WRITE NEWKEY macro instruction can be issued if DTFIS supports the 
ADD function. If a GET, PUT, or ESETL macro instruction is attempted, al 
it is ineffective and the bit remains set. 


2. It is possible for bit 3 to be set during the execution of the GET, PUT, or 
ESETL macro instruction; this reflects a hardware error. An indicator in 
the DTFIS-generated table marking the file as open is turned off, Further 
access to the file results in a fileenot-open error condition. 


Bit 4 — No ID Record Found 


1. If no record with an ID equal to that specified in a SETL macro instruction 
can be found in the file, or if the ID is not in a legitimate address range for 
the file (out of bounds), this bit is set. Further processing of the file is 
affected in the same manner as described for part 1 of bit 3. 


2. If the second parameter of a SETL macro instruction is KEY or GKEY, the 
identification in the data portion of the track index entry is not within the 
extents assigned to the files. 


Bits 5 and 6 — Unused 


Bit 7 — Record Retrieval from Overflow 


If the logical record retrieved by a GET macro instruction was taken from an 
overflow area, this bit is set. Processing of the record and the file proceeds 
normally. 
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s, APPENDIX G. ISAM FILE 
WS STRUCTURE 


G.1. GENERAL 


This appendix provides the ISAM user with the basic file structure of an ISAM file. 
It is intended to give a more detailed description of the internal ISAM structure than 
was presented in 4.2. Two complete examples, one illustrating initial loading of an 
ISAM file and the other showing file structure with overflow records, are given at the 
end of this appendix. 


G.2. SPACE ALLOCATION 


An indexed sequential file may be defined on one volume or on as many as eight 
volumes. All volumes of the file must be mounted and ready before the file is opened. 
The index area is always specified as being on volume 1. There may be eight prime data 
areas described, one for each volume. The independent overflow area may be on any 
volume but must only be described as one area. 


The volume table of contents (VTOC) for each volume will contain a format 1 label, 

which contains the 44-byte filename (from the LBL card) and the disc areas (extents) 

assigned to the file for this volume. A format 2 label is built to maintain ISAM file 

information on volume 1. The VTOC also contains a description of the device char- 

acteristics of the particular volume. These values are used to calculate effective 
<y record lengths and track configurations for each type of device. 


G.2.1. Disc Address 


ISAM disc addresses are described either by a five-byte disc identification (ID) 
field or a full eight-byte file-oriented address field. 


The five-byte disc ID address is of the form cchhr where, 


ce = two-byte cylinder number 
hh = two-byte head or track number 
r = one-byte record number 


The first byte of cc and hh is always zero for the UNIVAC 8411 and 8414 
Disc Subsystems. The first byte of cc may not be zero for the UNIVAC 
8424 Disc Subsystems. 


ISAM usually maintains an eight-byte disc address since it contains volume 
information. This address is of the form mbbcchhr where, 


m = ome-byte volume number (from one to eight) 
bb = two bytes of zeros for the UNIVAC 8411, 8414 and 8424 
Subsystems 


echhr = five-byte disc ID as described previously 


When issuing Seek or Search ID commands to the disc subsystem, the M is 

Sw used to choose the correct volume device address; bbcchh is used as the Seek 
argument, and cchhr as the Search ID argument. The disc ID forms the first 
five bytes of the count area of each disc record. 
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Unblocked 


Blocked 


Count 


Field 


G.2.3. 
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Prime Data Records 


NY 
Records in the prime data areas are stored sequentially by ascending keys. For 
unblocked records, the user’s key becomes the physical key on the disc; for blocked 
records, the key of the last logical record of the block is stored as the physical 
key of the record. 
Each record is of fixed length and is written onto the disc with count, key, and data 
fields. The count field contains the disc ID of the record, the key-length (from DTFIS 
keyword parameter), and the data length (unblocked = record size; blocked = record 
size times the blocking factor). 
For example, a breakdown of the fields for a record with a user key of 13 gives: 
Count Key Data 
13 
een ee Ne 
KEYLEN RCSZ 
Data (NRECDS=3) 
Count Key 
13 12 13 
NY 
a a atl ee ee a ai a 
KEYLEN RCSZ embedded 
Key=KEYLEN 
Key 
cc hh i Length Data Length 





RCSZ or 


KEYLEN 
RCSZ * NRECDS 


5 bytes 


Overflow Records 


After a file has been loaded, records with new keys may be inserted sequentially 
into the file. Areas for containing overflow records may be set aside by the user 
by reserving tracks associated with a particular cylinder (cylinder overflow) or by 
reserving an area associated with the entire file (independent overflow area). 


Overflow records are always stored in unblocked fixed-length format. Each record 

is written on the disc with count, key, sequence link, and data fields. The count 
field contains the disc ID of the record, the key-length (from DTFIS), and the data 
length (always = RCSZ+10). The key field contains the physical key of the logical 
record, while the data field contains a 10-byte sequence link field to chain overflow 


records (described in G.3.2) and the logical record. , ‘a 
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For example, a breakdown of the fields for an overflow record with key = 29 gives: 





Ne Count SL Data 
a | cea 
RCSZ 
Key 
Length Data Length ~< 


aan nen —s oe 


G.3. INDEXES 





For an JSAM file, two levels of indexes are maintained (a track index and a cylinder 
index) as well as an optional higher-level third index called a master index. 


The track index is the lowest level of index and appears at the beginning of each 
prime data cylinder. The number of track index entries needed for each cylinder 

and the format of the track index are determined by the loading procedure which is 
based on file specifications. At this time, it is also determined whether or not there 
is enough room on the track after the track index to allow for data records to share 


the track. 


The cylinder index occupies the space set aside by the user as the index extent. If 
: a master index is requested, it immediately precedes the cylinder index. Each entry 
in the master index contains the highest key on a cylinder index track. 


All index entries are of the same format, and contain count, key, and data areas. The 
count field of eight bytes is structured in the same way as that of a prime data record. 
The key field (length determined by the KEYLEN parameter in DTFIS) is used for search- 
ing the indexes, while the data field is always 10 bytes. The data field contains a 

full eight-byte disc address of either the next lower level index, the prime data track, 

or the first record of an overflow chain. The ninth byte of the data field, called the ‘‘f’’ 
flag, specifies the type of index entry, the validity of the entry, and the type of search 
required next. The tenth byte is unused and is merely maintained for compatibility 

with other systems. 


The indexes are terminated with ‘‘dummy’’ entries (shown as D in the examples), with 
keys of all 1 bits (highest key in the collating sequence) and data areas of all zeros. 
These entries terminate the index searching and isolate ‘‘no find’’ conditions in the 


indexes. 


Chaining entries (in the case of cylinder and master indexes only) are used to link 
cylinders of index entries. They appear in the last record of the last track of each 
cylinder of index entries. A chaining entry has a key of all 1 bits and contains the 
address of the next cylinder of index entries. When index scanning takes place in 
multiple track mode, these entries eliminate a premature ‘‘no find’’ condition. The 
entries are not illustrated in the examples because they are of no value to the user. 
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G.3.1. Track Index 


For each track containing prime data records within the cylinder, two entries are atl 
provided in the track index: the track normal entry and the track overflow entry. 

A dummy entry terminates the track index. As the file is loaded, the highest key 

of each prime data track is stored in both its normal and overflow track index entries. 

The data areas are set up to point to the prime data track as illustrated in Example 

1 at the end of this appendix. 


@ Track Index Normal Entry (for a track shared with data records): 


m ce hh r f 
Key 


Data Field 


NOTE: ris the first prime data record number on a shared track. The f flag 
indicates a shared track condition. 


@ Track Index Normal Entry (for a track not shared with data records): 


m cc hh r f 


8000 





Key Data Field ee 
NOTE: r=0 and the f flag indicate that the track contains only data records. 


gw Track Index Overflow Entry (with no active overflow area): 
r f 


As records are inserted into the file in the overflow areas, the address in the track 
index overflow data fields is altered to point to the first record in the overflow 

area. The key of the overflow entry still reflects the highest key originally associated 
with the prime data track, but the key of the track index normal entry is altered to 
reflect the highest key remaining on the prime data track. For example: 





Key Data Field 
NOTE: 1:=X'FF' and f flag indicate no overflow. 


mg Track Index Normal Entry (after adding records): 





Key Data Field 


NOTE: Key =27 is the highest key on prime data track 1, after adding three records 
to the file. 
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m Track Index Overflow Entry (with an overflow area): 
m cc hh r f 





Key Data Field 


NOTE’: Key=33, which was the highest key on prime data track 1, is now the 
highest key in the overflow area. The address (cchhr) points to the 
disc address of the first record in the overflow area, which in this case 
is the third record placed there. The f flag is changed to indicate that 
the TI entry is now active. Refer to Example 2 for further explanation of 
overflow record entries. 


G.3.2. Cylinder Index 


As the file is being loaded, an entry is made into the cylinder index for each 
cylinder of prime data records. The key of the cylinder index entry is the highest 
prime data key within the cylinder. The data field of the cylinder index entry gives 
the address of the corresponding prime data cylinder. 


The cylinder index entry for the first prime data cylinder (Example 1) would be: 





ey Data 





Count Field Data Field 


NOTE: The count field address (cchhr) is an approximation. Key=95 is the highest 
prime data key in the cylinder, and the f flag indicates an active cylinder 
entry. 


G.3.3. Master Index 


If a master index is requested, an entry is made for each track containing cylinder 
index entries. The key of the master index entry is the highest key on the cylinder 
index track, while the data field gives the address of the corresponding cylinder 
index track. 


The master index entry for the first cylinder index track (Example 1) would be: 


Data 


Count Field Data Field 





NOTE: The count field address (cchhr) is an approximation. Key=720 is the 
highest key on the cylinder index track, and the f flag indicates an active 
master index entry. 
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G.4. OVERFLOW CONTROL 


When a record is inserted into an ISAM file, it is placed in the prime data track or 
overflow area sequentially by key. Thus, if a record with key=18 is inserted into | 
the file (see Examples 1 and 2 at the end of this appendix), it would be placed 
between keys 16 and 19. All succeeding records would be moved down the track 
and the displaced record (key=33) would become an overflow record. 


G.4.1. Cylinder Overflow Control Record 


If the user has specified cylinder overflow, a cylinder overflow control record 

is written in the first record area (record 0, head 0) of each cylinder during loading. 
This record maintains the address at which a cylinder overflow record can be 
written. The cylinder overflow control record has no key field, but it is eight bytes 
long and has the form hhrbbtxx, where 


hh = two bytes indicating the last track containing overflow records. 
r = one byte indicating the last overflow record number. 


t = one byte indicating the remaining number of available tracks in the cylinder 
overflow area. 


bb and xx = 0’s. 
An unused cylinder overflow control record (Example 1) would be: 
hh t bb t XX 
WY 
7 3 
The current cylinder overflow control record (Example 2) would be: 
hh r bb t 
fades 
If the cylinder overflow area is full or if only independent overflow was requested, 
the overflow record is written in a separate area. Fields in the DTFIS are maintained 


with the last independent overflow record address and the remaining number of 
available independent overflow tracks. 


XX 


G.4.2. Sequence Link Field 


Each of the records in an overflow area originally moved from the same prime data 
track are chained together by means of a sequence link field. The data field of 

the track index overflow entry contains the address of the first overflow record. 
The first 10 bytes of the data area of this record (the sequence link field) contains 
the address of the next overflow record. The last record in the chain contains the 
home address of the original prime data track. 


The sequence link field is formatted in the same way as an index data entry; that 
is, it contains an eight-byte disc address, an f flag, and an ignored 10th byte. 


UP-7629 
Rev. 2 


() 


UNIVAC 9400 Appendix G 


DATA MANAGEMENT SYSTEM 


SECTION: PAGE: 





The sequence link field for key=29 contains the address of key=33, and the f 
flag shows that this entry is not the last in the chain (Example 2). 





The sequence link field (see Example 2) for key=33 contains the address of 
track 1, and the f flag indicates that this is the end of the chain. 





G.5. ISAM FILE PROCEDURES 


Various file procedures for adding records and retrieving records (either randomly 
or sequentially) are covered in the following sections. 


G.5.1. Adding Records to File 


Add to the ISAM file, illustrated in Example 1, three records with the following keys: 
key=18, key=1, and key=24 respectively. The final results are shown in Example 2. 


mw Key=18 


(1) Search indexes (see G.5.2) for a track index entry with key > 18. Result: a 
track index normal entry with key=33 is found which points to prime data track 
1. 


(2) Scan track for first key > 18. Result: the record with key=18 is inserted 
between records with key=16 and key=19. 


(3) Enter record with key=18 onto prime data track and move all succeeding records 
down the track one logical record position. Result: the record with key=33 
is pushed off the track and must be written in an overflow area. 


(4) The cylinder overflow control record specifies that track 7, record 1 is available. 
Write the record with key=33 in overflow record format, with a sequence link 
field which points to the home address of track 1. Alter the cylinder overflow 
control record to reflect that record 1 has been used. 


(5) Alter the track index overflow entry data field to point to the disc address of 
record key=33 (first record in overflow chain). 


(6) Alter the track index normal entry key field to record key=29 (highest key on 
prime data track). 
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G.5.3. 


m@ Key=1 
(1) Follow procedure for key=18 as previously described. Result: a record with wae 
key=4 is now written in the overflow area. The track index overflow entry data 
field points to record key=4. The track index normal entry key is set to key=2. 
@ Key=24 
(1) Follow procedure for key=18 (steps 1 through 3). Result: a record with key=29 
must be written in the overflow area. 
(2) Get the ID from track index overflow entry data field and put it in the sequence 
link field of the record with key=29. 
(3) Write record key=29 to overflow area based on the cylinder overflow control 
record. Alter the cylinder overflow control record. 
(4) Alter the track index overflow entry data field to point to a record with 
key=29. 
(5) Alter the track index normal entry key field to key=27. 
G.5.2. Random Retrieval on Prime Data Track 
Random retrieval of record with key=2; see Examples 1 and 2. 
(1) Search the master index for an entry with key > 2. Result: a record with 
key=720 is found which points to a cylinder index track address. 
ad 
(2) Search the cylinder index track for an entry with key > 2. Result: a record 
with key=95 is found which points to a prime data cylinder. 
(3) Search the track index of the prime data cylinder for an index entry with key 
> 2. Result: a record with key=2 is found from a track index normal entry 
which points to a prime data track address. 
(4) Search the prime data track for a record with key=2. Result: read the record 
with key=2. 
Random Retrieval From an Overflow Area 
Retrieve a record with key=33; see Examples 1 and 2. 
(1 and 2) Same as for random retrieval on prime data track; that is, a record with 
a key=33 would yield the same master and cylinder index entries. 
(3) Search the track index for an entry with key > 33. Result: a record with 
key=33 is found in a track index overflow entry and its data address yields 
an overflow record ID. 
(4) Compare key of this overflow record (key=29) to the record with key=33. Result: 
no match can be found; therefore, only read the sequence link field, which 
points to the next record in the chain. 
(5) Compare the key of the record whose address is in the sequence link field a 
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(key=33) to the record having key=33. Result: match can be found; 
therefore, read the record. 
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For random retrieval and add operations, all or part of the cylinder index may 
meme reside in main storage. This will eliminate disc accesses to the higher-level 
indexes. 


G.5.4. Sequential Retrieval Starting With Specified Key 
Start sequential retrieval with key=2; see Example 2. 


a Issue a SETL macro instruction to retrieve a record with key=2. 
(1...3) Same as for random retrieval on a prime data track. 


(4) Search prime data track for a record with key=2 and save the address of the 
record, 


gm Issue GET macro instructions to retrieve the records. For each GET instruction 
issued, the results are: 


(1) First GET instruction: the record with key=2 is retrieved from track 0. 


(2) Second GET instruction: the prime data record is at the maximum value 
(physical end) for a shared track; therefore, read the next overflow track 
index entry. Since it is marked ‘‘active’’, start the retrieval process from 
the overflow area using the disc address in the track index overflow entry. 
Result: the record with key=4 is retrieved from track 7; also, save the 
sequence link field for this record. 


(3) Third GET instruction: examine the sequence link field. Since ‘‘f’’ flag 
all indicates an end-of-chain condition, update the prime data track address. 
Result: the record with key=5 from track 1 is retrieved. , 


When the end of prime data track 1 is reached, the next track index overflow 
entry is examined, and a GET macro instruction would then retrieve the record 
with key=29. For a subsequent GET instruction, an active sequence link field 
would retrieve the record with key=33. 


The GET, PUT and ESETL macro instructions do not require access to the master 
and cylinder index areas, nor to the track index normal entries. 


G.5.5. Sequential Retrieval Starting With Specified ID 


Start sequential retrieval with the eight-byte ID 
(the ID of the record with key=2). 


m cc hh r 
Pet fodede 
wg Issue SETL Instruction. 


(1) Determine if the ID is on a prime data track, in a cylinder overflow area, 
or in an independent overflow area. Result: the record is found to be on a 
prime data track. 


(2) Calculate the associated track index entry address based on the input ID. 
No index searching is required for this example. 
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@ Issue GET instructions. 


Example 1: Initial Load of an ISAM File, Showing Key Structure 


m Master and cylinder indexes share the user-specified index extent. Assume 
cylinders 2 through 10 on volume 1 have been assigned as the index extent. 


Je CCH OSSEHEESEHEHOSESSHOHHHOLEHEHEBEEHOOLS 





MASTER 
INDEX 
TOTAL 
INDEX 
EXTENT 
CYLINDER 
INDEX 
m For the track index of the first-prime data cylinder, assume cylinder 11 on volume 
1. Three tracks have been set aside for cylinder overflow, and track 0 is shared 
with data records. Therefore, the track index contains 15 entries, including the 
dummy entry. 
Track 0 Track 1 Track 2 Track 6 
a ee ee i 





m The first prime data cylinder is loaded with unblocked records, as illustrated. 
Since cylinder overflow has been specified, a cylinder overflow control record 
(COCR) is written on track 0, record 0; and track 0 is shared with data records. 


Track First Prime Data Cylinder 


0 | cocr | Track Index 
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@ The second and last prime data cylinders are shown in order to relate 
entries to the higher-level indexes. 


2nd Prime Data Cylinder Last Prime Data Cylinder 


Track Index [io Track Index } > | 


Prime Data 
















8000 End of 
Prime Data =a ees File 
Cylinder Overflow Area Cylinder Overflow Area 
(Cylinder 12 on Volume 1) (Cylinder 5 on Volume 2) 


Example 2: ISAM File Structure with Overflow Records 


m After the addition of three records into the file, with keys=18, 1, and 24 respectively, 
the track index entries for tracks 0 and 1 are altered as follows: 


Track 0 Track 1 Track 2 Track 6 
et i ti 


m= The first prime data cylinder now shows three entries in the cylinder overflow 
area. 


Track First PD Cylinder 





0 Track Index 
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/ APPENDIX H. DISC SPACE 
a REQUIREMENTS FOR 


ISAM FILES 


H.1. GENERAL 


This appendix describes the space requirements for the UNIVAC 8411, 8414, or < 
8424 Disc Subsystem for the various elements of ISAM files. Constraints on the disc 

extents are detailed, and the formulas (including examples of their use) for computing 

the disc space requirements are given. 


H.2. CONSTRAINTS ON ISAM DISC EXTENTS 


A maximum of eight volumes can be used for the file. There can be only one prime 
data extent per volume, but the index or independent overflow extents, or both, can 
be on the same volume as a prime data extent. A prime data extent must begin and 
end on cylinder boundaries, but can be located anywhere on the volume. If there is 
more than one prime data extent for the file, the extents need not be continuously 
addressable. 


There is only one index extent for the file, which always contains the cylinder index. 

If the file is to have a master index, the required space is allocated in the low-order 

portion of the index extent. The index extent must be in the first volume of the file. 

If there is another extent for the file in the same volume, the index extent must come 

first; that is, it must appear in an EXT Job Control statement before the other extent, 
but it does not have to occupy the low-order portion of the disc. Also, the index extent 
~~ need only be an integral number of tracks, and it does not have to begin or end on 

cylinder boundaries. 


The use of an independent overflow area is optional; if an overflow area is used, 
the required extent can appear on any volume of the file. It must be an integral 
number of cylinders and must begin and end on cylinder boundaries. 


H.3. FORMULAS FOR DISC SPACE REQUIREMENTS 


Disc space requirements are derived by using the proper formulas. Information 
concerning these formulas is presented under the following subheadings: 


— Notes and conventions 

— Basic calculations 

— Prime data cylinder capacity 

— Higher level index requirements 


— Overflow area requirements 


H.3.1. Notes and Conventions 


(1) The formulas which follow do not explicitly refer to the track descriptor record 
P 
(RO) on each track or to the count area of each physical record, but they do 
allow space for them. 


(2) The notation used is standard, but the following conventions are submitted for 
clarification: 


(a) Multiplication is denoted by an asterisk (*) because of typing considerations. 
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(b) Division is normally real; however, where the numbers are in brackets, the 
real number quotient is to be truncated to an integer (by ignoring its fractional ~ 
portion and keeping only the integer). For example: 


3625/250 = 14.5, and 3/4 = 0.75, but 
[3625/250] = 14, and [3/4] = 0. 


Differences in formulas with respect to the UNIVAC 8411 Disc Subsystem, 
UNIVAC 8414 Disc Subsystem, and the UNIVAC 8424 Disc Subsystem are 
represented by four factors expressed in lowercase letters. These factors 
are constants whose values for each subsystem can be found: in Table H—1. 


DESCRIPTION CONSTANT 8411 DISC 8414/8424 DISC 


Number of tracks per cylinder 


Adjusted number of bytes per track 


Tolerance factor 


Record overhead 





Table H~1. UNIVAC 8411 and 8414/8424 Formula Differences 


H.3.2. Basic Calculations 


Bl. 


B2. 


B3. 


B4. 


BS. 


Index record length (IRL) 

IRL = (KEYLEN +10)*tol)+ohd 

Maximum number of index records per track (MXIR) 
MXIR = [(trksz—(KEYLEN+10))/IRL]+1 

Number of bytes in a data block (BDB) 

BDB = KEYLEN+(RCSZ*NRECDS) 

where: NRECDS is taken as 1 for unblocked records 
Data block length (DBL) 

DBL = (BDB*tol)}+ohd 

Maximum number of data blocks per track (MXDB) 


MXDB = [(trksz—~BDB)/DBL]+1 


B6. Number of data blocks on a shared track (SHDB) 


B7. 


B8. 


SHDB =.[(trksz—BDB—(n*IRL))/DBL]+1 


where: n is the number of TI entries on the shared track (see H.3.3.1 and 
H.3.3.3). 


Overflow record length (OFRL) 

OFRL = [(KEYLEN+RCSZ+10)*tot]+ohd 

Number of overflow records per track (NOFR) 
NOFR =.[(trksz—(KEYLEN+RCSZ+10))/OFRL]+1 
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Prime Data Cylinder Capacity 


The capacity of a prime data cylinder is defined as the number of logical records 
that it can contain. This number does not include any logical records in overflow 
areas associated with the cylinder. Records in a prime data area are referred to 
as prime data records, while those in an overflow area are referred to as overflow 
records. 


The capacity of a prime data cylinder depends on the number of tracks available 
for prime data records and the number of records that can fit on each track. The 
number of tracks available depends on the number of tracks set aside for cylinder 
overflow (from a minimum of 0 to a maximum of 8) and the amount of space required 
by the track index (from a minimum of a fraction of track 0 to a maximum of tracks 
0 and 1 for the UNIVAC 8411 disc, or a maximum of tracks 0 and 1 and a fraction 
of track 2 for the UNIVAC 8414 disc and the UNIVAC 8424 disc). There are 

six possible variations with respect to the size of the track index (TI) as follows: 


@ Track 0 Shared 


The track index resides on track 0 with enough space left over for at least one 
data block. There are 2n+1 TI entries, where n equals ntrk minus the number 
of cylinder overflow tracks, with two entries for each track from 0 through n—-1, 
and a dummy entry. 


m Track 0 Nonshared 


The track index resides on track 0. No space is left over for data blocks. There 
are 2n—1 track index entries, two entries for each track from 1 through n—1, and 
a dummy entry. 


mw Tracks 0 and 1 Shared 


The track index is too large to fit on track 0, and the extra entries are placed 
on track 1. There is enough space left over on track 1 for at least one data 
block. There are 2n—1 track index entries, two for each track from 1 through 
n—1, and a dummy entry. 


a Tracks 0 and 1 Nonshared 


The track index is too large to fit on track 0, and the extra entries are placed 
on track 1. No space is left over on track 1 for data blocks. There are 2n—3 
track index entries, two for each track from 2 through n—1, and a dummy entry. 
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mw Tracks 0, 1, and 2 Shared 


The track index is too large to fit on tracks 0 and 1. The extra entries are 
placed on track 2. There is enough space left over on track 2 for at least one 
data block. There are 2n—3 entries, two entries for each track from 2 through 
n—-1, and a dummy entry. 


m Tracks 0, 1, and 2 Nonshared 


The track index fits on tracks 0, 1, and 2. No space is left over on track 2 for 
data blocks. There are 2n—5 entries, two for each track from 3 through n—1, 
and a dummy entry. 


m Track Index Size Formulas 


The formulas and procedures that follow show how to compute the size of the 
track index and the capacity of a prime data cylinder. Many of the factors that 
enter into these calculations are derived from the basic calculations given in 
H.3.2. Current track (CURTRK) can be track 0, 1, or 2. Initially, the current 


cas track is track 0; therefore, CURTRK-=-0. 
$1. Number of prime data tracks (NTPD) 
NTPD = ntrk—(number of cylinder overflow tracks) 
$2. Number of track index entries (NTI) 
NTI = (2*NTPD)+1 
S3. Does track index fit on current track? Test (NTI:MXIR). 
NTI>-MXIR — track index does not fit, go to S4. 
NTI = MXIR — track index fits, but current track is nonshared, go to S6. 
NTI<MXIR — track index fits, and current track is possibly shareable, go 
to S5. 
set S4. Decrement NTPD by 1 and recompute NTI as NTI = (2*NTPD)+1 — 


(MXIR*CURTRK). 

Does track index now fit on current track? Test (NTI:MXIR). 

NTI>MXIR — track index still does not fit, go to S7. 

NTI<MXIR — track index now fits. Set SHDB to 0, go to S8. 

S5. Test shareability of current track. 

(a) Compute space available for data (SAD) 
SAD = trksz—(NTI*IRL) 

(b) Is there space for at least one data block? Test (BDB:SAD). 
BDB>SAD — No, the track is not shareable. Go to S6. 


BDB<SAD -— Yes, the track is shareable. Compute the number of 
data blocks on the shared track, SHDB. 
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87. 


S8. 


S9, 


(c) 
(d) 
Decrement NTPD by 1 and set SHDB to 0. Go to S8. 
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SHDB = [ (SAD-BDB)/DBL | +1 


Go to S8. 


Compute the number of track index entries on current track + 1. 


CURTRK = CURTRK#I1. 


t 


NTI = NTI-MXIR 


Go to $3. 


t 


Compute cylinder capacity in blocks (CBC) and records (CRC). 


(a) 


(b) 


If SHDB = 0, CBC = NTPD*MXDB. 


If SHDB # 0, CBC 


Wn 


((NTPD-1)*MXDB )+SHDB. 
CRC = CBC*NRECDS,(NRECDS is taken as 1 for unblocked records). 


Compute the total file capacity in blocks (FBC) and records (FRC). 


(a) 
(b) 
(c) 


FBC = CBC*(number of prime data cylinders)-MXDB 
FRC = FBC*NRECDS,(NRECDS is taken as 1 for unblocked records). 


To find the number of cylinders required to hold a given number of 
records, add MXDB*NRECDS to the actual number of records, divide 
this sum by the cylinder capacity in records (CRC), and round upwards. 


Higher Level Index Requirements 


There is a cylinder index entry for each prime data cylinder. If there is a master 
index, it has an entry for each track occupied by the cylinder index. For each. 
type of index, there is a dummy entry marking the end of the index, and a chaining 
entry which is required each time the index crosses a cylinder boundary. Thus, if 
an index has entries on n cylinders, there are n—1 chaining entries. 


In the control stream, one extent (the first entry on the EXT statement for the first 
volume) should be assigned as the higher level (master index, MI, or cylinder index, CI) 
extent, but it need not begin or end on cylinder boundaries. The program subdivides 

the space between the CI and the MI, allowing the maximum possible space for each. 
(Of course, if an MI is not used, space is not allocated for one.) The CI is checked 

for adequate space against the number of prime data cylinders; if the CI space is 
adequate, the MI space is also adequate. 


The MI, if present, occupies one or more tracks at the beginning of the extent, while 
the CI begins with the track immediately following the last MI track. 


Depending on the actual disc addresses involved, there can be some variation in 
the size of the MI and CI because of the presence or absence of chaining entries. 
The formulas which follow (I1 through 15) allow for the maximum size. Quotients 

are to be rounded to the next higher integer. 


I1, Minimum number of CI entries (MNCI) 


MNCI = (# Prime Data cylinders) + 1 
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12. Number of CI tracks (NCIT) 


NCIT = (MNCI+((MNCI/MXIR)~1)/ntrk)/MXIR 
13. Minimum number of MI entries (MNMI) 

MNMI = NCIT+1 
14. Number of MI tracks (NMIT) 

NMIT = (MNMI+((MNMI/MXIR)—1)/ntrk)/MXIR 
I5. Number of higher level index tracks (NHLT) 

NHLT = NMIT+NCIT 


H.3.5. Overflow Area Requirements 


Formulas B7 and B8 (see H.3.2), which give overflow record length (OF RL) and 
the number of overflow records per track (NOFR), respectively, are all that are 

required to compute the disc space requirements for a given number of overflow 

records. They apply to both the cylinder and the independent overflow areas. 


H.4. SAMPLE DISC SPACE CALCULATIONS 


The following two sample calculations are for unblocked and blocked records, 
respectively. 


H.4.1. Unblocked Records, Cylinder Overflow, Track 0 Shared 


Initial volume is 90,000 records, each record is 80 bytes long with a 10-byte key, 
and one track per cylinder is allowed for overflow. DEVICE = 8411. 


(1) Basic Calculations 
Bl. IRL = (10+10)*1.05+81 = 102 
B2. MXIR = [(3605-(10+10))/102] = 35 
B3. BDB = 10+(80*1) = 90 
B4. DBL = (90*1.05)+81 = 175.51 
BS5. MXDB = [(3605-90)/175.51] +1 = 21 


(2) Prime Data Cylinder Capacity 
Sl. NTPD = 10-1 =9 
$2. NTI = (2*9)+1 = 19 
S3. (19<35) 


SS. (a) SAD = 3695-(19*102)=1667 
(b) (90<1667) 
(c) SHDB = [(1667-90)/175.51] +1 = 9 










UP-7629 
Rev. 2 











UNIVAC 9400 


DATA MANAGEMENT SYSTEM Appendix H 


SECTION: PAGE: 


$8. (a) CBC = (9-1)*2149 = 177 
(b) CRC = 177*1 = 177 


( ' 


S9. # Prime Data cylinders required = (900004+21)/177 = 509 


(3) MI/CI Requirements 
Ii, MNCI = 509+1 = 510 
12, NCIT = (510+((510/35)-1)/10)/35 = 15 
13. MNMI = 15+1 = 16 
14, NMIT = (16+((16/35)-1)/10)/35 =1 
I5. NHLT = 1+15 = 16 


(4) Overflow Area Requirements 
B7. OFRL = ((10+80+10)*1.05) +81 = 186 
B8. NOFR = [(3605-(10+80+10))/186] +1 = 19 


At one overflow track per cylinder, there are 9671 possible overflow records, 
or approximately 10 to 11 percent of the prime data capacity. 


H.4.2. Blocked Records, No Cylinder Overflow, Track 0 Nonshared 


Initial volume is 2,500 records, each record is 200 bytes long with 50-byte embedded 
keys, records are blocked at 3-per-block and cylinder overflow is not specified. 
DEVICE = 8411. 


(° 


(1) Basic Calculations 
Bl. IRL = ((504+10)*1.05) +81 = 144 
B2. MXIR = [(3605-(50+10))/144] +1 = 25 
B3. BDB = 50+(200*3) = 650 
B4. DBL = (650*1.05}+81 = 682.5 
B5. MXDB = [(3605-650)/682.5] +1 =-5 


(2) Prime Data Cylinder Capacity 
$1. NTPD = 10-0 =.10 
$2. NTI = (2*10)+1 = 21 
$3. (21<25) 


S5. (a) SAD = 3605-(21*144) =.581 
(b) (650>581) 


S6. NTPD = 10-1 = 9 


SHDB = 0 


Co 


S8. (a) CBC = 9*5 = 45 
(b) CRC = 45*3 = 135 


S9. # Prime Data cylinders required = 2500+(5)*(3)/135 =. 19 
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(3) MI/CI Requirements 


12. 
12. 
NOTE: 


MNCI =.19+1 = 20 
NCIT = (20+((20/25)-1)/10)/25 =1 


In this case, with just one track for cylinder index, a master index would 
be pointless. 


Unblocked Records, No Cylinder Overflow, Track 2 Shared 


Initial volume specifies a key length of 250 and record size of 270. DEVICE = 8414. 


(1) Basic Calculations: 


Bl. 
B2. 
B3. 
B4. 
BS. 


IRL = [(250+10)*1.044] +146 = 417.44 
MXIR = [(7249-(250+10))/417.44] +1 = 17 
BDB = 250+(270*1) = 520 

DBL = (520*1.044)+146 = 688.88 

MXDB = [(7249-520)/688.88] +1 = 10 


(2) Prime Data Cylinder Capacity 


S1. 


82. 


S3. 


$4. 


S7. 


83. 


S4. 


S7. 


83. 


85. 


$8. 


NTPD = 20 
NTI = (2*20)}+1 = 41 
41>17 Track index does not fit on track 0. —w 


NTPD = 20-1 = 19 
NTI = (2*19) +1-(17*0) = 39 
39>17 Track index still does not fit on track 0. 


CURTRK = 0+1 = 1 
NTI = 39-17 = 22 


22>17 Track index does not fit on track 1. 


NTPD = 19-1 = 18 
NTI = (2*18) +1-(17*1) = 20 
20>17 Track index still does not fit on track 1. 


CURTRK = 1+1 = 2 
NTI = 20-17 = 3 


3<17 Track index now fits on track 1 and current track (track 2) is possibly 
shareable. 


(a) SAD = 7249-(3*417.44) = 5997 
(b) 52<5997 Track 2 is shareable. 
(c) SHDB = [(5997-520)/688.88] +1 =9 


(a) CBC = ((18-1)*10) +9 = 179 
(b) CRC = 179 
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S9. (a) FBC = 179*(number of prime data cylinder)-10 
ee” (b) FRC = FBC 
(c) To hold a file of 100,000 records 
100010/179 =.559 cylinders required for prime data extent. 


(3) Master Index and Cylinder Index Requirements 
Il. MNCI=.559+1 = 560 


12. NCIT = (560+ (222-1 )/20)/17 = 34 


13. MNMI = 3441 = 37 
14, NMIT = (35+((35/17)*1)/20)/17 = 3 
15. NHLT = 3+34 = 37 


(4) Overflow requirements 
B7. OFRL = [(250+270+10)*1.044]+146 = 699 
B8. NOFR = [(7249-530)/699]+1 = 10 


Se 
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= 
APPENDIX |. PRINTER FORMS 
HANDLING 
INFORMATION 
~ The printer software prints a maximum of two normally spaced lines (depending on number 


of 1/0 areas) whenever forms overflow is recognized. The user must, therefore, be careful 
not to place forms overflow punches in the carriage tape too close to the home paper punch, 
as the skip to home position may have already passed the position needed to recognize the 
home position, and the overflow routine may skip a page. 


The UNIVAC 0768 (Model B) Printer no longer has a switch to control 6—8 lines-per-inch 
spacing. The setting of this option is accomplished in the following manner: 


If six-lines-per-inch spacing is desired, punch 14 (2,4,8) in the paper tape loop ‘home’ 
position. 


If eight-lines-per-inch spacing is desired, punch 15 (1,2,4,8) in the paper tape loop for 
‘home’ position. 


Place the carriage tape in the printer and home the paper twice while in off-line mode. 
The printer will set itself to six or eight line spacing according to the punches for home 
position, When the printer is placed online, spacing will be according to the setting thus 
determined. A control command skip-to-14 (or skip-to-15) will then be recognized as 
skip-to-home, regardless of the line spacing. 


Using a UNIVAC 0768 (Model B) Printer, the maximum number of lines spaced after 
printing is three. Users of earlier model printers (Model A with the manual 6—8 switch) 
may find it necessary to punch both a 14 and a 15 in adjacent positions on the paper 
tape loop, in order to accomplish both the skip-to-15 command used by Data Manage- 
ment and the skip-to-14 command which may be in a user’s printer overflow routine. 
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APPENDIX J. DATA MANAGEMENT 
COMMON CODE 


J.1. GENERAL 


In a multiprogramming environment, many of the Data Management modules are used by 
more than one program. Frequently used Data Management modules can be incorporated 
into the Supervisor during system generation. These modules, which are resident in 
the Supervisor, are referred to as common code. 


The Data Management modules are re-entrant; therefore, those modules resident in 
common code may be shared by all programs running in that environment. This saves a 
considerable amount of space in the system. Modules need not be linked into every 
program being executed. Only those modules frequently used should be included in 
common code. Less frequently used modules should be linked into those programs 
which need them. 


jJ.2. DATA MANAGEMENT COMMON CODE. UTILITY PROGRAM 


The Data Management Common Code Generator (DMCC) is a utility program. The user 
must specify the Data Management routines to be included in common code by means 
et of PARAM statements (see J.2.7). The output from the DMCC utility program is an 

optional source deck, a listing of defined labels, and a library tape having the object 

module of equates in the reserve file and the source code module in the source file 

(see Figure J-1). A sample control stream for a utility run is shown in J.2.9. 






USER 
PARAM 
STATEMENTS 











DMCC 
ROUTINE 














is, eres 
rat a Seas ea a | 

4 
LISTING OF DMCC 7 ma 
DEFINED LIBRARY I ee ! 
LABELS TAPE i’ 


Figure J~1l. Data Management Common Code Generator (DMCC) 
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J.2.1. Listing of Defined Labels 


Labels defined for the routines included in common code are listed on the printer. 
Some Data Management routines provide multiple functions which are found in smaller 
modules. These larger modules are called supersets. The smaller, more specific 
modules are called subsets. The superset modules may be used to replace one or 
more Subset routines. If a superset is included in common code, the label of the 

—>>- superset, as well as the labels of all its subsets, appears on the printer listing; 
however, only the superset appears in the common code. 


J.2.2. Object Module of Equates 


The object module of equates produced by the DMCC utility program is used by the 
Linkage Editor to satisfy external references (EXTRNs) in the user program’s DTF 
address table. These DTF addresses are external references to labels defined in 
common code. The equates contain information allowing the OPEN transient routines 
to complete the linkage to common code. 


{ The object module containing equates should be placed in the user’s Reserve 
library; the module is then readily available to the Linkage Editor. Programs 
which use common code and the auto include feature of the Linkage Editor 
should not specify an auto include reserve library containing Data Manage- 
ment commond code modules. Common code modules should reside in a 
reserve library other than the library designated to be searched for automatic 
inclusion modules. The module is placed in the library by using the Librarian 

4 routine. The Reserve library may be kept on tape or disc. Figure 3—2 shows 
how data from the system library tape is merged with the object module 
containing equates. et 


















DMCC 
LIBRARY 
TAPE 


SYSTEMS 
LIBRARY 
TAPE 





LIBRARIAN 
ROUTINE 





MERGED 
SYSTEMS 
TAPE 


Figure J~2. Placing Object Module in Tape Reserve Library 


For more explicit instructions, see UNIVAC OS/4 Tape Librarian Programmer Reference, 
UP-7667 (current version) or UNIVAC OS/4 Disc Librarian Programmer Reference, 
UP-7745 (current version). 
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Source Deck Assembly 


The source module of the DMCC library tape or the source deck produced by the 
DMCC must be assembled to produce an object module containing the common code 
and its index. Since the common code itself is generated by a series of Proc calls, 
use of the tape assembler is not recommended, nor should a Proc tape be specified 
to the tape/disc assembler. Figure J—3 shows use of the tape/disc assembler. 






SOURCE 
DECK 











MERGED 
SYSTEMS 
TAPE* 













TAPE/DISC 
ASSEMBLER 





TAPE/DISC 
ASSEMBLER 





COMMON 
CODE 






COMMON 






CODE OBJECT 
OBJECT MODULE 
MODULE AND INDEX 

AND INDEX 





*The DMCC library tape may also be used as tape input to the assembler. 


Figure J-3. Assembly of Source Modules 


Source Module Assembly Linkage 


The object module produced by the assembler has several control sections. These 
control sections are linked separately to produce the common code module and indexes 
associated with the module. 


= Common Code Module 


Common code must be linked separately as a load module. The module is then 
placed in the $Y$CTRL file of the system disc (see J.2.4). The Supervisor loads 
the module into storage from the disc at IPL time. Figure J—4 shows the use of 
the tape Linkage Editor. 


a Common Code Indexes 


The other control sections are indexes describing the displacement from the 
start of the common code load module of each label that could be defined in 
common code. The index entries are in fixed order. If the routine defining a 
certain label is not included in common code, its corresponding index entry is 
set to 0. These control sections are linked separately. The indexes are inserted 
into the transient routine area which is then placed in the $Y$TRAN file of the 
system disc (see J.2.3). 
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COMMON 
CODE 
OBJECT 

MODULE 
AND INDEX 


LINKAGE 
EDITOR 


COMMON 
CODE 
LOAD 

MODULE 


PAGE: 


The Data Management OPEN transient routines access the index to complete the 


user program linkage to common code. Figure J-5 illustrates the linking of the 


common code index. 


Figure J~5. Common Code Index Linkage 
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J.2.3. Setting Up the System Disc 


J.2.4. 


To provide the Supervisor with the facility for handling Data Management common code, 
the following options must be included in the specifications to the SYSTEM macro 
instruction (see UNIVAC 9400 System Supervisor Programmer Reference, UP-7689 
(current version). 










Bb OPERATION 6 OPERAND 










SYSTEM Nees 


ae ,DMCC 
The parameter DMCC generates the Supervisor facility for loading common code as 
part of the Supervisor. 


After the Supervisor is loaded into storage and the DMCC parameter has been specified 
in the SYSTEM macro instruction, the following typeout occurs: 


09 SV80 DMCC PKG?(A,B,...-OR NONE) 


The following response typein is required: 
O9R a 


where a is the unique characteristic letter (see J.2.6) of the common code module to be 
loaded as part of the Supervisor. If a common code module is not to be loaded, the 
operator may type in NONE in place of a. 


Placing Common Code Load Module and Index on System Disc 


Before the Disc Mapping Program can place the common code module and its index on 
the disc system, they must be placed in the Load library of a library tape. 


Figure J—6 shows the merged systems tape (see J.2.2) being merged with the common 
code index by the Tape Librarian. The common code index is in transient form, The 
common code load module and its index are both on the same OBJFIL tape as the 
Linkage Editor runs were stacked rather than placed on separate tapes. 


The Disc Mapping Program (DACMAP) places the common code load module and index 
in the appropriate files on the system disc. When the user requests the Supervisor to 
load a common code module, the Supervisor searches the $Y$CTRL file of the system 
disc for the module. When a program to be linked to common code is executed, the 
OPEN transient routine searches the $Y$TRAN file of the system disc for the common 
code index. ; 


Figure J—7 represents DACMAP placing the common code load module and the common 
code index in the$}Y$CTRL and $Y$TRAN files of the disc system, respectively. 
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SYSTEMS CODE CODE 
TAPE LOAD INDEX 
MODULE 
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FINAL 
LIBRARY 
TAPE 


Figure J-6. Placing Common Code and Index on Library Tape 










FINAL 
LIBRARY 
TAPE 






DACMAP 
ROUTINE 


Figure J~7. Placing Common Code and Index on System Disc 
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J.2.5. Linking User Programs to Common Code 


The user programs which are to be linked to common code must go through the Linkage 
Editor. The name of the object module of equates (see J.2.2), associated with the 
common code to which the program is linked, must be specified to the Linkage 

Editor by means of the following control statement: 


INCLUDE _ object-module-name 


The naming conventions for the object module are discussed in J.2.6. See J.2.10 
for a sample control stream for linking a user program with the object module of 
equates. 


The following error messages, which may be produced during the linking procedure, 
may be ignored: 


Tape link message — K734 
Disc link message — K834 


jJ.2.6. Naming Conventions and Multiple Common Code Modules 


It is possible to have more than one common code module in the $Y$CTRLarea of 
the systems disc. The user then has the option of selecting the common code module 
loaded at IPL time. 


The various common code modules are distinguished by a unique characteristic letter. 
This characteristic letter must be supplied to DMCC by the following PARAM statement: 





// PARAM } NAMEba 


POSITIONAL PARAMETER 


a — a unique alphabetic character which iS associated with the common code 


module, common code indexes, and the reserved library object module to 
be created. 


This statement must be the first PARAM statement specified to DMCC. If it is omitted, 
DMCC assumes A as the characteristic letter. 


The format of the name of the first control section of the source module (as well as 
the name of the source module itself), which in turn becomes the name of the common 
code module itself is: 


$D$MAa00 


where a is the unique characteristic letter of the common code module. (Default case: 
$DSMAA00.) 
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The format of the names of the other control sections of the source module which in 





turn become the names of the indexes associated with that common code module is: S 
$Y$MAa0m 

where a is the unique characteristic letter of the common code load module and m is 

the number of the index. (Default case of first index: $Y$MAA00) 

The format of the name of the object module is absolute equates used to link the user 

program to the common code module is: 
D9$MAa00 

where a is the unique characteristic letter of the common code module to which the 

user program is to be linked. (Default case: D9$MAAOO.) 

This is the object module name to be specified to the Linker Editor on an INCLUDE 

statement. 

jJ.2.7. PARAM Statement For Selection of Routines 

PARAM statements are used to select routines to be included in common code. The 

general format of the PARAM statement is: 

// PARAM codewordbloption-1][ ,option-2]... 

where codeword defines the Data Management file type being described and the options a 


describe the characteristics of the file processing to be provided for in common code. 
The options for a particular file type parallel the keyword parameters of that file 
type’s DTF macro instruction. 


Options may be listed in any order and are separated by commas. Scanning of options 
is terminated by the first blank encountered. 


Continuation statements are not recognized; that is, column 72 must be blank. If all 
options for a file cannot be contained on one PARAM statement, additional PARAM 
statements with the same codeword may be used. 


J.2.7.1. Printer Modules 


The following PARAM statement specifies which Data Management peter file 
options are to be provided in common code: . 





IOA1[(WORK)] 
// PARAM PR IOA2[(WORK)I{ |[,CNTRLI][, PRTOV] 
SUPER 
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CODEWORD: 
Nee 
PR — indicates that options refer to Data Management printer 
modules and automatically includes DP$CHK1 in common 
code. 
OPTIONS: 
IOA1 — includes DP$10E1 in common code. This module handles 
printer files having one I/O area and no work area. 
IOA1(WORK) — includes DP$11E1 in common code. This module handles 
printer files having one I/O area and a work area. 
IOA2 — includes DP$20E1 in common code. This module handles 
printer files having two I/O areas and no work area. 
IOA2(WORK) — including DP$21E1 in common code. This module handles 
printer files having two I/O areas and a work area. 
SUPER — includes DP$62E1 in common code. This module handles 
one or two I/O areas with or without a work area. This 
module should be included unless only one combination 
of I/O areas and work area will be used. 
CNTRL — includes DP$CNT1 in common code. This module handles 
Rt -8: the CNTRL imperative macro instruction for printer files. 
PRTOV — includes DP$PRT1 in common code. This module is needed 
when a printer overflow option is specified. 
J.2.7.2. Reader Modules 
The following PARAM statement includes the Data Management card reader module 
(DR$GET1) in common code: 
// PARAM READ 
J.2.7.3. Punch Modules 
The following PARAM statement specifies which Data Management punch file 
options are to be provided in common code: 
IOA1(WORK) 
// PARAM | PUNCH IOA2(WORK) 7? }[,CNTRL][,PUNR] 
| SUPER 
ee 
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J.2.7.4. 


CODEWORD: 


PUNCH 


OPTIONS: 


IOA1 


IOA1(WORK) 


10A2 


IOA2(WORK) 


SUPER 


CNTRL 
PUNR 


Readpunch Modules 














Appendix J 


SECTION: 


— indicates that options refer to Data Management punch 


PAGE: 


modules and automatically includes DW$CHK1 in common 


code. 


— indicates DW$10E1 in common code. This module handles 


punch files having one I/O area and no work area. 


— including DW$11E1 in common code. This module handles 


punch files having one I/O area and a work area. 


— includes DW$20E1 in common code. This module handles 


punch files having two I/O areas and no work area. 


— includes DW$21E1 in common code. This module handles 


punch files having two I/O areas and a work area. 


— includes DW$62E1 in common code. This module handles 


one or two I/O areas with or without a work area. This 
module should be included unless only one combination 
of 1/0 areas and work area will be used. 


— includes DW$CNT1 in common code. This module handles 


the CNTRL imperative macro instruction for punch files. 


— includes DW$RTY1 in common code. This module is needed 


when card punch error recovery has been specified. 


The following PARAM statement specifies which Data Management read/punch 
file options are to be included in common code: 


// PARAM 


CODEWORD: 
READPUNCH 


OPTION: 


CNTRL 


READPUNCH [CNTRL] 









— indicates that the option (if present) refers to the Data 


Management read/punch modules and automatically includes 


DQ$GET1, DQ$PUT1 and DW$CHK1 in common code. 


— includes DW$CNT1 in common code. This module handles 


the CNTRL imperative macro instruction for read/punch 
files, 


NOTE: DW$CHK1 and DW$CNT1 are modules shared by punch and read/punch files. 
They appear in common code only once even if specified more than once. 
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jJ.2.7.5. Indexed Sequential Modules 





The following PARAM statement specifies which Data Management indexed sequential 
modules are to be included in common code. 
SEQNTL }. 
// PARAMIIS [LOADI][,ADD] |,, RANDOM }] (,INDAREA][ IOSIZE][,BLK][ ,UNB] 
RANSEQ 

CODEWORD: 

IS — indicates that the options refer to Data Management indexed 
sequential modules. 

OPTIONS: 

LOAD — includes DU$LOAD1 in common code. This module is used 
when creating or extending files. 

ADD — includes DU$ADD1 and DU$WTF1 in common code. These 
modules are used when inserting records in a file. 

SEQNTL — includes DU$RESL1, DU$RSEQ1, DU$PUT1, and DU$RGET1 
in common code. These modules are used when sequentially 
retrieving records from the file. 

Newer” 

RANDOM — includes DU$RRANI, DU$RWRT1 and DU$WTF1 in common 
code. These modules are used when randomly retrieving 
records from the file. 

RANSEQ — includes DUS$RRAN1, DUSWRT1, DUSWTF1, DU$RESLI1, 
DU$RSEQ1, DU$PUT1 and DU$RGETI1 in common code. 
These modules will allow both sequential and random 
retrieval of records from a file. 

INDAREA — includes DU$RXCI1 in common code. This module is used 
when the resident cylinder index option is used. 

IOSIZE — includes DU$AMIO1 in common code. This module is used when the 
when the option of reading and writing an entire track at a 
time is specified. 

BLK — includes DU$ABLKI1 in common code. This module is used 
when inserting blocked records in a file. 

UNB — includes DU$AUNB1 in common code, This module is used 


when inserting unblocked records in a file. 
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The following PARAM 
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statement specifies which Data Management direct access 


modules are to be included in common code: 





// PARAM| DA [READ] [,WRITE] [,AFTER] [,RELATIVE[(IDLOC)] 
{[,ABSOLUTE[(IDLOC)]} 


CODEWORD: 
DA - 


OPTIONS: 


READ - 


WRITE a 


AFTER = 


CNTRL - 


RELATIVE - 


RELATIVE(DLOC) — 


ABSOLUTE - 


ABSOLUTE(IDLOC) — 


indicates that the options refer to Data Management direct 
access modules and automatically includes DD$CT1, DD$WT1 
and DD$AC1 in common code (see the AFTER specification 
for DD$ACl1 restriction). 


includes DD$RD1 in common code. This module handles the 
READ imperative macro instruction for direct access files. 


includes DD$WR1 in common code. This module handles 
update writes (that is, WRITE imperative macro instructions 
with either the ID or KEY positional parameter) for direct 
access files, 


includes DD$FW1 and DD$BCi in common code. DD$FW1 
handles format writes (that is, WRITE imperative macro 
instructions with either the RZERO or AFTER positional 
parameter) for direct access files. When AFTER is specified, 
DD$AC1 is not included in common code because it is a 
subset of DD$BC1. 


includes DD$SK1 in common code. This module handles the 
CNTRL imperative macro instructions for direct access files. 


includes DD$RL1 in common code. This module is needed 
whenever relative addressing is used in direct access files. 


includes DD$RL1 and DD$RW1 in common code. DD$RW1 
is needed if relative addressing is used and the IDBLOC 
option is requested. 


includes DD$ID1 in common code. DD$ID1 is needed if 
absolute addressing is used in direct access files. 


includes DD$ID1 and DP$AW1 in common code. DD$AW1Lis 
needed if absolute addressing is used and the IDLOC option 
is requested. 
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jJ.2.7.7. Sequential Disc Modules 


The following PARAM statement specifies which Data Management sequential disc 
file options are to be provided in common code: 





(BLK[,WORK]) 
// PARAM | SD [UPDATE[(WORK)I][,CNTRL]} ,INPUT { (UNB[,WORK]) 
(SUPER) 


(BLK[,WORK]) 


,OUTPUT, (UNB[,WORK]) 


CODEWORD: 


SD 


OPTIONS: 


UPDATE 


UPDATE(WORK) 


CNTRL 


INPUT(BLK) 


INPUT(BLK,WORK) 


INPUT(UNB) 


(SUPER) 


indicates that the options refer to Data Management sequential 


disc modules and automatically includes DS$ISS1 in common 


code unless UPDATE [(WORK)] is the only optional parameter. 


includes DS$ISU1, DS$GTF1, DS$PTF1, DX$ISS1, DS$WCI1 
and DS$RLU1 in common code. These modules are needed 
when sequential disc input files are to be read, modified 
and then written back into the same storage location. 


includes DS$ISU1, DS$GTF1, DS$PTF1, DS$WCI1, DS$RLU1 
and DS$MVRI1 in common code. This parameter is needed if 
sequential disc input files are to be updated and records in 
the input file are to be transferred from the input I/O area to 
a work area. 


includes DS$CNT1 in common code. This module handles 
the CNTRL imperative macro instruction for sequential 
disc files. 


includes DS$GTC1, DS$WCI1 and DS$RSE1 in common code. 
DS$GTC1 handles blocked sequential input files not using 
a work area. DS$WCI1 is needed with sequential disc input 
files and DS$RSE1 is needed with blocked sequential input 
files. 


includes DS$GTD1, DS$WCI1, DS$RSE1 and DS$MVRI1 in 
common code. DS$GTD1 handles blocked sequential input 
files using a work area. DS$WCII1 is needed with sequential 
disc input files and DS$RSE1 is needed with blocked 
sequential input files. DS$MVR1 is needed with sequential 
files using a work area. 


includes DS$GTA1 and DS$WCI1 in common code. DS$GTA1 
handles unblocked sequential input files, not using a work 
area. DS$WCI1 is needed for sequential disc input files. 


PAGE: 
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INPUT(UNB,WORK) — includes DS$GTB1, DS$WCI1 and DS$MVR1 in common code. 
DS$GTB1 handles unblocked sequential input files using ~~ 
a work area. DS$WCI1 is needed with sequential disc input 
files and DS$MVR1 is needed for sequential files using a 
work area. 


INPUT(SUPER) —includes DS$GTE1, DS$WCI1, DS$RSE1 and DS$MVR1 in 
common code. DS$GTE1 handles blocked or unblocked se- 
quential input files, using or not using a work area. DS$WCI1 
is needed with sequential disc input files and DS$RSE1 is 
needed with blocked sequential input files. DS$MVR1 is 
needed for sequential files using a work area. 


OU TPUT(BLK) — includes DS$PTC1, DS$WCO1 and DS$TNC1 in common 
code. DS$PTC1 handles blocked sequential output files not 
using a work area. DS$WCO1 is needed with sequential disc 
output files and DS$TNC1 is needed for blocked sequential 
output files. 


OUTPUT(BLK,WORK) — includes DS$PTD1, DS$WCO1, DS$TNC1 and DS$MVR1 
in common code. DS$PTD1 handles blocked sequential 
output files using a work area. DS$WCO1 is needed with 
sequential disc output files and DS$TNC1 is needed with 
blocked sequential output files. DS$MVRI1 is needed for 
sequential files using a work area. 


OUTPUT(UNB) — includes DS$PTA1 and DS$WCO1 in common code. DS$PTA1 
handles unblocked sequential output files, not using a work 
area. DS$WCO1 is needed with sequential disc output files. 


OUTPUT(UNB,WORK) — includes DS$PTB1, DS$WCO1 and DS$MVRI1 in common 
code, DS$PTB1 handles unblocked sequential output 
files using a work area. DS$WCO1 is needed with sequential 
disc output files and DS$MVRI1 is needed for sequential 
files using a work area. 


OUTPUT(SUPER) -— includes DS$PTE1, DS$WCO1, DS$TNC1 and DS$MVR1 
in common code. DS$PTE1 handles blocked or unblocked 
sequential output files, using or not using a work area. 
DS$WCO1 is needed with sequential disc output files and 
DS$TNC1 is needed with blocked sequential output files. 
DS$MVR1 is needed for sequential files using a work area. 


J.2.7.8. Sequential Tape Modules 


The following PARAM statement specifies which Data Management sequential tape 
file options are to be provided in common code. 





(BLK[,WORK]) (BLK[,WORK]) 
// PARAM | MT [BACK]] ,INPUT { (UNB[,WORK]) ,OUTPUT 4 (UNB[,WORK]) 
(SUPER) (SUPER) 
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CODEWORD: 


MT - 


OPTIONS: 


BACK _ 


INPUT (BLK) - 


INPUT(BLK,WORK) — 


INPUT(UNB) - 


INPUT(UNB,WORK) — 


INPUT(SUPER) - 


OU TPU T(BLK) - 
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indicates that the options refer to Data Management sequential 


tape modules and automatically includes DS$ISS1 and DT$CTL1 


in common code. 


includes DT$GTG1, DT$WKB1 and DS$RSE1 in common code. 
DT$GTG1 handles blocked or unblocked sequential input files, 
using or not using a work area, whether they are being read 
forward or backward. DT$WKB1 is needed with sequential tape 


input files being read backward but will also handle these files 
if they are being read forward. DS$RSE1 is needed for blocked 
sequential input files. 


includes DS$GTC1, DT$WKI1 and DS$RSE1 in common code. 
DS$GTC1 handles blocked sequential input files not using 

a work area. DT$WKII1 is needed with sequential tape input 
files and DS$RSE1 is needed for blocked sequential input 
files. 


includes DS$GTD1, DT$WKI1, DS$SRSE1 and DS$MVR1 in 
common code. DS$GTD1 handles blocked sequential input 
files using a work area. DT$WKI1 is needed with sequential 


tape input files and DS$RSE1 is needed with blocked sequential 


input files. DS$MVR1 is needed for sequential files using a 
work area. 


includes DS$GTA1 and DT$WKI1 in common code. DS$GTA1 
handles unblocked sequential input files, not using a work 
area. DT $WKI1 is needed for sequential tape input files. 


includes DS$GTB1, DT$WKI1 and DS$MVR1 in common code. 
DS$GTB1 handles unblocked sequential input files using 

a work area. DT$WKI1 is needed with sequential tape input 
files and DS$MVRI1 is needed for sequential files using a 
work area. 


includes DS$GTE1, DT$WKI1, DS$RSE1 and DS$MVR1 in 
common code. DS$GTEI1 handles blocked or unblocked se- 
quential input files, using or not using a work area. DT$WKI1 
is needed with sequential tape input files and DS$RSE1 is 
needed with blocked sequential input files. DS$MVR1 is 
needed for sequential files using a work area. 


includes DS$PTC1, DT$WKO1 and DS$TNCI1 in common code. 
DS$PTC1 handles blocked sequential output files not using 

a work area. DT$WKO1 is needed with sequential tape output 
files and DS$TNC1 is needed for blocked sequential output 
files. 
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OUTPUT(BLK,WORK) — includes DS$PTD1, DT$WKO1, DS$TNC1 and DS$MVRI1 in 
common code. DS$PTDI1 handles blocked sequential output 
files using a work area, DT$WKO1 is needed sequential 
tape output files and DS$TNC1 is needed with blocked 
sequential output files. DS$MVR1 is needed for sequential 
files using a work area, 


OU TPUT(UNB) — includes DS$PTA1 and DT$WKO1 in common code. DS$PTA1 
handles unblocked sequential output files, not using a work area. 
DT$WKO1 is needed for sequential tape output files. 


OUTPUT(UNB,WORK) — includes DS$PTB1, DT$WKO1 and DS$MVR1 in common code. 
DSS$PTB1 handles unblocked sequential output files using 
a work areae DT$WKO1 is needed with sequential tape 
output files and DS$MVRI1 is needed for sequential files 
using a work area. 


OUTPUT(SUPER) -— includes DS$PTE1, DT$WKO1, DS$TNC1 and DS$MVRI1 in 
common code. DS$PTE1 handles blocked or unblocked 
sequential output files, using or not using a work area. 
DT$WKO1 is needed with sequential tape output files and 
DS$TNC1 is needed with blocked sequential output files 
and DS$TNC1 is needed with blocked sequential output 
files. DS$MVR1 is needed for sequential files using a work 
area. 


Shared Sequential Modules 


Sequential disc and tape Data Management share many modules. Even if certain 
shared modules are included by the MT and the SD positional parameters, these 
modules are included only once in common code. As mentioned in J.2.1, some 
Data Management modules include the function of other modules. This is true 
of many of the shared modules. After all PARAM statements have been inter- 
preted, DMCC determines whether more than one subset module has been re- 
quested. If so, the superset module is placed in common code instead of the 
subset modules. 


Tables J—1 and J—2 show modules generated by INPUT, OUTPUT, and BACK 
optional parameters. 






CODEWORD OPTION DS$GTA1 | DS$GTB1 | DS$GTC!1 | DS$GTDI | DS$GTE1 | DT$GTGI | DS$MVR1 | DS$RSE1 | DS$WCI] | DTSWKIT | DT$WKBI 


ee aan a Se Manes oS Oe 
s ee ee ee ef 
EEE 


. ae ant 
















NOTES: (1) Subsets of DS$GTE1 
(2) Subsets of DT$GTG1 


(3) Subset of DT$WKB1 


Table J~1l. Modules Included by Input Options of SD and MT Codewords and BACK Option of MT Codeword 
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*Subsets of DS$PTE1 





Table J~2. Modules Included by Output Options of SD and MT Codewords 
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jJe2.7.10. Summary of PARAM Statements 


Table J~3 summarizes the PARAM statements recognized by the DMCC. 


a 


IOA1 [(WORK)] 
// PARAM 


IOA2 worn} [,CNTRL] [,PRTOV] 
pivearam | READ Td 

















SUPER 





IOA1(WORK) 
// PARAM PUNCH IOA2(WORK) L,CNTRL] [,PUNR] 
SUPER 







// PARAM READPUNCH [CNTRL] 


SEQNTL 
// PARAM [LOAD] [,ADD]], ; RANDOM }| [,INDAREA] 


Is 
RANSEQ 
{,IOSIZE] [,BLK] [,UNB] 
_ 
“mm 








[READ] [,WRITE] [,AFTER] [,CNTRL] 
[,RELATIVE [(IDLOC)]] [,ABSOLUTE [(IDLOC)]] 








[UPDATE [(WORK)]] [,CNTRL] 


(BLK [,WORK]) (BLK [,WORK]) 
ANPUT {(UNB [,WORK])}}],OUTPUT{ (UNB [,WORK]) 
(SUPER) (SUPER) 














(BLK [,WORK])) || _ (BLK [,WORK]) 
[BACK] ] , INPUT {(UNB [,WORK])}]],OUTPUT{(UNB [,WORK]) 


(SUPER) (SUPER) 





Table J~3. Summary of PARAM Statements 
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J.2.8. DMCC Routine Control Stream Requirements 



































A sample control stream for the DMCC follows: recs 
LABEL t OPERATION 6 OPERAND 6 
16 
Lf, JOB, i i back RUN | Job Step 1: Execute DMCC 
/ CPLTLeIN NOMI ee ee ie Se SS ee Pe eh gp Soe 
al 2 | These cards may be omitted if punched card 
//,_ LED, ||) Punic WiC ueiuaeee ieee mee 
iA ove, 1 31 
7A, LED, : PRAITIR 
/, DViC. 5 Obed ae yas Wes ae me Wer On Yew ed Pe ee See Ge Dh a | 
// NO | ABCs ys Cs CRD Wee ees Se Hee OT Yr Oe ae OS SP cee Re | 
//_ LED | | Lt Bolus, lpg fg pe 4 
// EXEC, ||) DMCKL LOADS LIB» REL 
Af, PARA | NAME! D Lu poleepe pee sale seas ies gy | 
AIRA areas Ey iD Ne Peet Gis ee We UE ae 
Perce ees A 
ie acters elke arte ee 
i aenea eee Bnd of DMCC job van 
This sample control stream is the first job step for the control stream examples 
given in J.2.9.and J.2.10. 
ABC345 is the volume serial number of an output tape, and D is the unique character- 
istic letter of the common code module to be generated. The NAME statement 
must be the first PARAM statement. If it is omitted, A is assumed as the character- 
istic letter. 
If the punch is not specified, the following message appears on the console 
DM43 UUU PUNCH 
Ignore the message and allow the DMCC routine to terminate normally. 
{ J-2.9. Control Streams for Setting Up Common Code Disc System 
Two sample control streams for setting up a common code disc system are presented as 
follows: 
m The following sample control stream merges a systems tape and the DMCC library 
| tape and assembles and links the common code module and the index transients a 
SS 


created by DMCC, placing them on the disc in the appropriate libraries. 


Refer to Table J—4 for a description of the mounting scheme. 
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A, DOO, CALT library of a library tape for use when linking. 


ADD oe SS sO SC CS CS EO EE COON 


7 e 
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~ 

7 LABEL $ OPERATION 6 OPERAND 1 

— 1 10 16 
Cf OG | Sem|ulP Job Step 2: Build system library tape | 
Mi Pats (MOM a eminem iden len aaa tien hears 
Lf, DVic 3 fe tad eh eae lk ee] hee ai ee poets epg ol 
ee Te sith 
Lf, DNC 5 
7/4 Vet, (1) ABCBHS, . 1 Library output tape of DMCC. 
// FD, | ALTIL| D poirtiririr tipi t 
//, Dv. | 116 i erecre yO Yes RES pa Seale eva Ue | 
Jf VL Fi ABcl2ite. | L4 Systems tape. The object module and source 

| | module are placed in the Reserve library and 

FAC 3 J rarer rari cere 
4/4 Dve . || 7 @ TY el YON Pe Ts VOY GA Us Es a ay 
f/f, VOL. HEARSE RE 
//, LF iD 4 LIBpur Poop Pa Pa 
41 Exe¢, ||) trp LeOADSit Bay REL 
Sade Nl iy ; feiss depo ie lS it ed ie eg ie re 
kre, {| IP Ll5 NOB Poo pe Py a Pa 

Rey | ADDR, | | D éladoo ALT This module should be kept in the Reserve 
|. ADDS, | | M 
aaa 5 


per tlorea ti yyy bu pi 





Job Step 3: Assemble source modules 
































//, OPR.| 11 DISMCUNT, TAPE, ABCZ4ib Sah pie S| 

[ GPR, t | REP ; iE WITH, TAPE, ASMZ6, ! | Meee La Nese | ol Tear Ean b | 
// OP ik 1 XMOUINT, TAPE, AB C468, ON, DV, Bisiiiil 
11, OPTICN NOV RO hehe pep ee Eee no et eg pd 
if ING | 143, 
Af, FD, PPAR te 
//, Du 5 . 

The DMCC library tape is no longér needed 

/ / Vo --amce bs as was coe nateae velane ABCS37. 
Lf DNC Vb | 


~ 
~ 


res i ASMZ2I6 Since volume ABC537 is a copy of volume 
ABC246, this tape need not be changed if 
the user wishes to reuse volume ABC246 
as a scratch tape. It is recommended to 

aro save it and mount another tape. Volume 


Rog [AA LED, | | | $cRial tii yt... ASM26 is used as a scratch tape. 
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LABEL 6 OPERATION & OPERAND 1} : : 
10 16 dl 





/, Dvic 
/, N@t 
fLFiD 
{, DV 
L, V@L 
{, LED, 
//_DN 





' 1 1 I t 
ane This tape is specified only if input to DTASM 
is from tape. 


RIESig Pg Peat oe Eee he ae 

















~ 
=~ 
=< 
Ce 












1 
poetiyr pil 





The control stream assumes that the Proc 
library is on disc. It is recommended that 
a disc Proc library be used. Use of a tape 
Proc library is time consuming. 


Cc 
2 i ee ! 
M. > LOAD SLT Bios REL Use of a tape assembler 





If EXIEC 





eich oes would be inefficient. 
zee ee 1 ’ 

/./, PARAM IN =|¢Ip 5 MAD OO/'S RES If user is assembling Se, 

source deck, the deck 

should be inserted here 

preceded by a /$ card 

and succeeded by a /* 

card. The PARAM state- 

ment is then omitted. 
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AD OO module itself, 
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LABEL t OPERATION & OPERAND +) 
10 16 
il | 2 ; ee ees i Job Step 4: Link object modules 
{ERA Briel te Gg al ag eae lp pea ey Ih 
1 ABCBHS Poppa tee pa Pa et Pa 
a 6 a popu td py py Peat Pay t 
- ASMizl6 pee terp etre ri tyre tari tai ia t 
LDMEILL 
Ameo ee 0 Cie ae 
HL. ||) ABCII3,7 
LL LED if SRES 1 
gs DNC. = pret ou yap tea ye tee pit 
L1 vel _ABCHI6s 
//,_ LED eBule 
(lf, EXe¢ PL uate LOEADSFL LB. RE The tape Linkage Editor 
| LOADM | 1 404MMlaD.00,1X,' 00! These LOADM, INCLUDE 
} oe and ENTER statements 
INCL ulp : paboc DOS MAIDOOS Lal link the common code 











( I | ‘ ' ot | tot ' ' | 
The LOADM, INCLUDE, 
and ENTER statements 
link the common code 
index. 


rotate ppp treet payee tei i tii ii bt 
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LABEL & OPERATION 6 
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/, GP 





/, DNC 





SIL 





/, LED 
f, DNC 


eb sal 
{Veit || ABCs 
|) Lr Blu, 
Ee oe 
i, VAt,, 111 ASM 
(LED, 11) CBaleL 
Nae ns 
a tt ABE B.7 
/. Leo. Vl CBee 
L Exe ||. Ure 


MIS IN ER ER EK EE ER ES LE EE ER ET 
* Px _— ~~ iS 
> Vir 
og SS < [nm 
(s) co 
ao a 
Q 


LIB | | TPL INALT 
cPvi, ||) Te slsceNoo 
| .S03IMADoo 
AyD. | |) TRalgv¥$.MADOG 
Rees i 


|, LGADSLI Bel, REL 
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6 


Ly Job Step 6: Common code and index to tape 
pte a 


Volume ABC345 becomes the final library 


CE Me Chee ADC Un et eB a 


a 


The common code module 
and its index must be 
placed on a library tape 
before mapping them to the 
the disc. 
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JOB STEPS Dvc Dvc 
5 6 7 
1. DMCC VOL ABC345 
LIBOUT 
2. LIBS ABC345 VOL ABC246 VOL ABC537 
ALTLIB LIBIN LIBOUT 


3. DTASM VOL ASM26 VOL ABCO021 VOL ABC022 
SCR1 SCR2 SYSPOOL SYSPOOL 


4. (TAPE) LINK SCR1 LDMFIL 


iw] 
> 
4 
> 
= 
> 
Zz 
> 
a 
m 
= 
m 
Zz 
+ 
nn 
< 
“n 
=| 
m 
= 


6. LIBS LIBOUT OBJFIL 


7. DACMAP VOL ABC020 
LIBIN SYSMAP 
SYSCNTRL. 
SYSTRAN 


Table J~4. Control Stream Mounting Scheme 


5. (TAPE) LINK isa SCR1 LOMFIL 
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a The following sample control stream utilizes the disc assembler and disc 
. linker for the common code module and the index transients created by 
= DMCC when the procs and reserve modules reside in a disc library. 
DASM4 is used here for the UNIVAC OS/4 program utilization with the 
UNIVAC 9700 System. DASM4 is replaced by DASM for the UNIVAC 
9400 System. 
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ADOO .COOG Job step 1: Execute DMCC 
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punched card output is not 
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AAAAAA is the volume serial 
number of an output tape. 

The user may mount a scratch 
tape. 







Z is the unique characteristic 
letter of the common code 
module to be generated. 
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//, PARAM 
pcb ppp Insert desired parameter cards 
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OS4LBS contains the standard 
disc proc library and a SYSPOOL 
area. 
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1 10 
//_ Exec, || Dash ‘ 

/P AIRA a | AGN; ql DS MAZO0, /ALIT. If assembling from source deck, 
deck is placed here, preceded 
by a /$ card and succeeded by 
a /* card. The PARAM statement 
is then omitted. 
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BBBIBABRE BBBBBB is the volume serial 
number of an output tape. The 
user may mount a scratch tape. 
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[_ \ IDUMP_, _, Job step 5: Merge common code 
on system tape 
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CCCCCC is the volume serial 
number of a tape containing a 
copy of OS/4 in standard tape 
library format. 








DDDDDD is the volume serial 
number of a tape containing 
the merged system tape and 
data management common 
code. 
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i. ec, iss module and index on disc 
41 _t ead Cine) et nv) Hewes Eos Le Goce! Sed COM CO! Ee Co ence Cm eae Meme Oe 
/, DNC. | O Sh ad 
Z/_ LED ||) PRAMTIR 
4/ Dwe, 11, AS, || 
G6 Neb. |. DDDIDEP 
// LED, || BL 
fee renee eee 
/ Ve, 111 XXX XXXXXX is the volume serial 
number of the systems disc 
onto which common code is 
to be mapped. 
D SYSIMAP 
7 ING , || L 
// Ve, |. xX 
Bi. ; RA XXX 
pe a a 
= is ™. 
f LBL SIC Ribas XIKKKK ~ 


YJ 
I 


APOO, ,LOADSLIB, REL 


MOD 
OO 


A 


MOO 


aN aN 
ayy oN 
Ls | [Ss ~ alm 
>, » ~ 0) 
3 CO ‘ 
Re 
es 
pds Pe Se ale Pies ell: te be pa 


¥ 
() 
O 


> 
ow, 


Lp ra. Co cA 4 pa | ree wea | 
BS eal IQ ir 4 
Fr | Gr |) x 7 em 
_ | siz is ir Tale Ook] xT 
= 


UP-7629 
Rev. 2 














UNIVAC 9400 Appendix Jj 


DATA MANAGEMENT SYSTEM 





SECTION: PAGE: 


J.2.10. Control Stream for Linking User Program to Common Code 


Two sample control streams for linking the user program to common code 
are presented as follows: 


] The following is a sample control steam for linking a user program to 
the common code module produced in J.2.8. 
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library output tape from the fa 
= first control stream in J.2.9. It <_ 
has the object module, DO9$MADOO, 
11 in the Reserve library. tt 
See ee cet eC ne ed Ue Wn) eC oO a 
1 Ni mil 3 Output tape for user’s linked program. 
//, LED HL LD MIELE fouirii tog 
Lf, DV fin ad Assumes user’s object module is on au 
|) DEITIBA an assembler OBJFIL tape. ! 
1 eB ulFILL 
Ce ae 
SC RII pte be a 
LiL TNIK LOADS IBets REL pei titi tipi tia 
/$ fl 
pa LewDH Li nema addi, 


P INCLUDE Lmoldu (enamel LCS gee Sm) IL, filename 
SINT Sere O This INCLUDE statement is required , | 


when linking a program to common 
code. 


|. : ENITER| | | ex pitession | Refer to UNIVAC OS/4 Linkage Editor |, 


Programmer Reference, UP-7703 (current 
version) for instruction on completing 
other control statements. 


1 peo tbirvr a terre trae terra tiie baa 
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a The following sample job control stream illustrates the linking of a user test program 
named DMTEST with common code modules created in J.2.9. 
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sMANILDUMP) , , Job step 1: Build a temporary 


user reserve library 


ehorrai te tare etapa pe te pa tai pa t 





Fae ee eas Ons oo OO CO MC 
DDDDDD is the volume serial 
number of a tape which is the 
output of the fifth job step of 

the preceding sample job stream. 














EEEEEE is the volume serial 
number of a tape which contains 
the assembled output of the 
user’s text program, DMTEST, 
in the reserve library. 


OS4LBS is the volume serial 
number of a disc containing 
the standard system reserve 
library (RESV$LIB) and file 
in which a temporary reserve 
library may be built (USERLIB). 
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ADD R | | Das HAzoc ALT. 
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ZZ eerie 1 Nevielt MAN LDUMP, Job step 2: Link test program 
with common code. 
@) poty rir tire t 
7 eps ee 
Af DNG th 2, || 
Jf. V@L 1 EERIE FFFFFF is the volume serial 
number of the output tape onto 
which the user’s program is 
linked. 
Lane 
OS4LBS is assumed to have a 
SYSPOOL area. 
SYSCR1 is a scratch disc con- 
taining a SYSPOOL area. 
SIPES 
LL VEL. || \ Lies po Pe a a a 
ZZ LBL. ||) USERILTE 
Lf, LED | RESNES 
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J.3. ERROR MESSAGES 


= DM43 UUU PUNCH eee 
Explanation: 
This informational message appears on the console if the user chooses not to 
produce punched card output. 
Action: 
None required. Processing continues. 
w ERROR - INVALID CARD IN JOB STREAM — SCAN TERMINATED HERE 
Explanation: 
An invalid statement has been encountered while scanning PARAM statements. 
The scan ends at this point; however, DMCC processing continues. 
Action: 
Correct the statement in error and resubmit the job. 
a ERROR ~- invalid parameter 
Explanation: 
An invalid parameter has been encountered while interpreting a PARAM statement. 
DMCC discontinues scanning the statement and prints out the statement starting 
with the erroneous parameter. at 


Action: 


Correct the statement in error and resubmit the job. 


mw ERROR — PARAM MISSPELLED 


Explanation: 


A statement begins with two slashes, but the slashes are not followed by BPARAMB. 
The statement is ignored and the next statement is read. 


a DM46 uuu filename 


Explanation: 


When using common code, the OPEN transient routines make this typeout if an 
error is encountered as the user program is being linked to common code. 


uuu represents the logical unit number of the device; filename is the label of the 
user’s DTF macro instruction. 
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PAGE: 


The error conditions causing this typeout are: 


— A DTF macro instruction slot contains a label which must be defined by common 
code and no common code was loaded at IPL time. 


~— The bit masks of the common code module and the common code index do not 
match. The bit mask is a 32-byte area whose setting represents the modules 
generated in common code. This error condition would occur when more than 
one common code has been generated and the characteristic letters used were 
not unique. 


— A DTF macro instruction contains a label which must be defined by common code 
and the common code loaded at IPL time does not define this label. 


— The OPEN transient routine is unable to retrieve the index. This may be caused 
by an I/O error or by a missing index. 


Action: 


Resubmit the job after correcting the error. 
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Term 


Absolute addressing 


Absolute request denial 
allocate routine 


Adding records, DAM 


Adding records to file, ISAM 
key=1 
key=18 
key=24 
procedures 


Additional volume labels format 
AFTER keyword parameter 


ALLOC macro 
disc space management 


Allocate routine 
invalid parameter specification 


Allocate routine error codes 

cannot allocate absolute request 

contiguous request unable to be 
assigned 

invalid parameter specification 

invalid PUB or volume serial 
number 

1/0 

more than 16 extents 

no room in VTOC 

no room on disc 


DATA MANAGEMENT SYSTEM 


Reference 


4.1.3 


G.5.1 
G.5.1 
G.5.1 
G.5.1 


Figure 2—2 


4.1.1 


5.5.1 
5.5.1 


5.5.1 
5.5.1 
5.5.1 
5.5.1 
5.5.1 


4-15 


5-5 


5-8 





Term 


B 
BACK options 
Bit 0 — unrecoverable Device error 
Bits 1 through 4 — unused 
Bit 5 — duplicate key 
Bit 6 — overflow area full 
Bit 7 — unused 


Block numbering 
magnetic tape, SFP 


Block size 
card device 
DAM 
direct access storage devices 
introduction 
magnetic tape, SFP 
optical character recognition (OCR) 
optical document reader 
paper tape 
printer 


Blocked cylinder, no cylinder overflow, 
track 0 nonshared 


Blocked records 
input 
ISAM 
output 
variable length 


Blocking factor, ISAM 


INDEX 


Reference 


Table J—1 


3.2.3 
4.1.1 
3.2.2 
4.1.1 
3.2.1 
3.2.5 
3.2.5 
3.2.6 
3.2.4 


H.4.2 


3.3.4 
G.2.2 
3.3.5 
3.3.3.2 


PAGE: 


Page 


J-17 


3-29 
4-3 
3-17 


3-1 

3—48 
3-47 
3-64 
3-38 
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Term Reference Page Term Reference Page 
eet 
Braces 1.2 1-3 Checkpoint blocks 2.2.3 2-10 
Brackets 1.2 1-3 CLOSE macro 
example 4.1.2.8 4-30 
Bypass checkpoint dumps 3.3.8 3-83 
magnetic tape, SFP 3.2.1 3-4 format 4.1.2.8 4-29 
3.3.8 3-83 
Cc function 41.28 4-29 
rewinding magnetic tape 3.2.1 3-4 
Capacity record, DAM SFP 3.3.8 3—83 
count area 4.1.2.3.1 4-25 
data area 4.1.2.3.1 4-25 CLOSE transient routine names 
discussion 4.1.2.3.1 4-25 DTFCD D.4 p-2 
DTFDA D.6 D-2 
Capital letters 1.2 1-3 DTFIS 0.7 D-2 
DTFMT 0.2 D~-1 
Card and printer conventions DTFOR D.8 D-3 
end-of-data (*job control statement) 2.4.2 2-36 DTFPR D.5 p-2 
introduction 2.4 2-36 DTFPT D.9 D-3 
printer/punch — first character control 2.4.3 2-36 DTFSD D.3 D-1 
start-of data ($job control statement) 2.4.1 2-36 
CNTRL macro 
Card device, SFP examples 3.3.6 3-79 
block size 3.2.3 3-29 format 4.1.2.5 4-26 
control entry 3.2.3 3-29 3.3.6 3-78 __ 
current record pointer 3.2.3 3-31 function 4.1.2.5 4—26 
end of an input file 3.2.3 3-30 parameter list Table 3-8 3-42 
first character control 3.2.3 3-29 READ macro 4.1.2.5 4-26 
input translation table 3.2.3 3-31 SFP 3.3.6 3-78 
introduction 3.2.3 3-27 WAITF macro 4.1.2.5 4-26 
1/0 area 3.2.3 3-31 WRITE macro 4.1.2.5 4-26 
1/0 mode 3.2.3 3-31 
keyword parameter, OTFCD macro 3.2.3 3-27 Code conversion, printer 3.2.4 3-39 
major file error 3.2.3 3-30 
optional input file 3.2.3 3-33 Code/font relationship 
output block size 3.2.3 3-32 optical document reader 3.2.5.1 3-62 
output translation table 3.2.3 3-33 Table 3-10 3-62 
overlap 3.2.3 3-32 
punch error recovery 3.2.3 3-33 Commas 1.2 1-3 
record format 3.2.3 3-34 : 
record size 3.2.3 3-34 Common code 
4.2.1 4-42 linking user programs J.2.5 J-7 
secondary I/O area 3.2.3 3-31 modules, multiple J.2.6 J-7 
stub cards 3.2.3 3-34 placing load module and index J.2.4 J—-5 
type of file 3.2.3 3-34 Figure J-7 J—6 
validity check 3.2.3 3-28 source module assembly linkage J.2.2.2 J-3 
work area processing 3.2.3 3~35 
Console messages 
Carriage overflow condition, printer 3.2.4 3-43 error codes TableE-1 E-2 
explanation E.1 E-1 
Character mismatch oes 


printer 3.2.4 3-38 | Contents following initialization, volume 5.3.2 5-4 
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Term 


Contiguous request unassignable 
allocate routine 


Continuation statements 
Control character in data records 


Control entry 
card device 
DAM 
direct access storage devices 
declarative macro 
first character control 
optical document reader 
printer 
punch recovery 


Control stream for linking user program 
to common code 


Control stream for setting up common 
code disc system 
explanation 
mounting scheme 


Count area, DAM 


Count area on disc 
cyclic check 
data length 
flag byte 
format 
identifier 
key length 
record number 


Current record pointer 
card device 
direct access storage devices 
ISAM 
magnetic tape 
optical document reader 
paper tape 
printer 


Cyclic check 
count area on disc 


Cylinder index in main storage, ISAM 


Cylinder number, count area on disc 


Reference Page 


5.5.1 5-9 

J.2.7 J-8 

2.4.3 2-36 
3.2.3 3-29 
4.1.1 4-5 

3.2.2 3-18 
4.1.1 4-5 

3.2.3 3-29 
3.2.5 3-49 
3.2.4 3-38 
3.2.3 3-33 
J.2.10 J-27 
J.2.9 J-20 
Table J-4 J-26 


4.1.2.3.1 4-25 


2.3.9 2-33 
2.3.9 2-33 
2.3.9 2-33 
Figure 2-21 2-32 
2.3.9 2-33 
2.3.9 2-33 
2.3.9 2-33 
3.2.3 3-31 
3.2.2 3-20 
4.2.1 4-39 
3.2.1 3-7 

3.2.5 3-51 
3.2.6 3—67 
3.2.4 3-42 
2.3.9 2-32 
4.2.1 4-37 
G.3.2 G-5 

2.3.9 2-32 





Term 


Cylinder overflow 
ISAM 
track 0 shared 


Cylinder overflow control record, ISAM 
file structure 
current 


unused 


DACMAP 


DAM 
absolute addressing 


Reference Page 


add records to existing file on current 


track 
AFTER keyword parameter 
block size 
capacity record 
CLOSE macro 
CNTRL macro 
control entry 
count area 
creating a sequential file 


creating user standard header labels 


4.2.1 4-36 
H.4.1 H—6 
G.4.1 G-6 
G.4.1 G-6 
J.2.4 J-5 
4.1.1 4-15 
4.1.3 4-30 
4.1.1 4-3 © 
4.1.1 4-3 
4.1.2.3.1 4-25 
4.1.2.8 4-29 
4.1.2.5 4-26 
4.1.1 4—5 
4.1.2.3.1 4-25 
4.1.3 4-30 
4.1.2.6 4-27 


data area 4.1.2.3.1 4—25 
data management error analysis routine 
(DMEAR) 4.1.4 4-30 
declarative macro 4.1.1 4-2 
delete records on given track within file 4.1.3 4-30 
device type 4.1.1 4-5 
end of cylinder Table4—1 4-6 
end of file Table4—1 4-6 
end of volume Table4—1 4-6° 
error status codes 4.1.1 4-5 
extent checking 4.1.2.6 4—28 
files and OPEN macro 4.1.2.6 4-27 
function 41 4~—1 
ID 4.1.1 4-13 
Table4—2 4-11 
imperative macros 4.1.2 4—20 
index areas 4.2 4-31 
input files 4.1.2.1 4-20 
instruction usage 4.1.3 4-30 
invalid ID Table4-—1 4-6 
1/0 area 4.1.1 4-11 


1/0 area contents for logical IOCS 


Table4—3 4-12 
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Term 


DAM (cont) 
key field 
key length 
keyword parameters for DT FDA macro 
LBRET macro 
lockout table 
major file error 
OPEN macro 
output files 
PARAM statement 
prime data areas 
processing user header labels 
READ macro 
read record by KEY 
reading a sequential or random file 
record format 
record key by ID 
record size 
relative addressing 
relative record addressing 
relative track addressing 
RELEX macro 
search multiple tracks 
seek address 
special label handling 
special extent 
track overrun 
track protection 
track user label format 
type of file 
updating a sequential or random file 
user extent processing 
user island code 
user label format, track 
verification requirements 
VOL statement 
WAITF macro 
WRITE macro 
write record by ID 
write record by KEY 
wrong length 


Data area, DAM 


Data check in key or data 
direct access method 


Data check — count area 
DAM 


Data conversion feature 


Reference Page 
4.1.1 4-12 
4.1.1 4-12 
Table4-4 4-19 
4.1.2.6 4-27 
4.1.2.7 4-29 
4.1.1 4-9 
4.1.2.1 4-20 
4.1.2.1 4-21 
J.2.7.6 J—12 
4.2 4-31 
4.1.2.6 4-27 
4.1.2.2 4-22 
4.1.1 4-13 
4.1.3 4-30 
4.1.1 4—14 
4.1.1 4-13 
4.1.1 4-14 
4.1.1 4-14 
4.1.1 4-16 
4.1.1 4-15 
4.1.2.7 4-29 
4.1.1 4—16 
4.1.1 4-15 
4.1.1 4-13 
4.1.1 4-17 
Table4-1 4-6 
4.1.1 4-9 
Figure 2-19 2-31 
4.1.1 4-16 
4.1.3 4-30 
4.1.2.6 4-28 
4.1.2.6 4-28 
Figure 2-19 2-31 
4.1.1 4-17 
A.3.1 A-6 
4.1.2.4 4-26 
4.1.2.3 4-23 
4.1.1 4-17 
4.1.1 4-17 
Table4—1 4-6 
4.1.2.3.1 4-25 
Table4—1 4-6 
Table4—1 4-6 
2.2.5 2-12a 
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Data input 
disc space management 
format labels 
use/availability recording technique 
volume contents following initialization 
VTOC capacity 


Data length 
count area on disc 


Data management common code 
error messages 
introduction 
utility program 


Data management dummy control section 
function 
instruction format 


Data management error analysis routine 
(DMEAR) 
calling procedures 
console output 
nonsequential file processing 
restrictions 
sequential file processing 


Data management register conventions 
Data management source deck assembly 


Declarative macro instruction 
control entry 
DAM 
general function 
ISAM 
SFP 


Defined tabels, listing 

Deleting records, DAM 

Device type 
DAM 
direct access storage devices 
iSAM 

Direct access method 

Direct access storage device conventions 


disc format 1 labels 
disc format 2 labels 
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5.3 

§.3.1 
5.3.3 
5.3.2 
5.3.4 


J.3 
JA 
J.2 


1.5 
1.5.1 


3.4 
3.4 
4.14 


3.4 


J.2.2.1 


4.1.1 
4.1.1 
1.1.2 
4.2.1 
3.2 
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See DAM 
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Direct access storage device conventions (cont) 


disc format 3 labels 

disc format 4 labels 

disc format 5 labels 

disc user header/trailer labels 
disc volume labels 
introduction 

record types 


track organization for user header/ 
trailer labels 


Direct access storage devices, SFP 


( \ 


block size 

control entry 

current record pointer 

device type 

end of an input file 

file updating 

introduction 

1/0 area 

keyword parameters for DT FSD macro 

major file error 

optional input file 

record format 

record size 

secondary 1/0 area 

short blocks 

special label handling 

type of file 

unique file errors 

variable-length record residual 
space 


work area processing 
write verification 


Disc address, ISAM file structure 


disc identification (ID) field 

error field bit settings — sequential 
retrieval 

file-oriented address field 

space allocation 


Disc areas 


index 
overflow 
prime data 


Disc extents 


constraints 


Reference 


2.3.4 
2.3.5 
2.3.6 
2.3.7 
2.3.1 
2.3 

2.3.9 
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2-24 
2-26 
2-28 
2-29 
2-13 
2-13 
2-32 


Figure 2—20 2—32 


2.3.8 


3.2.2 
3.2.2 
3.2.2 
3.2.2 
3.2.2 
3.2.2 
3.2.2 
3.2.2 
Table 3~2 
3.2.2 
3.2.2 
3.2.2 
3.2.2 
3.2.2 
3.2.2 
3.2.2 
3.2.2 
3.2.2 


3.2.2 


3.2.2 
3.2.2 


G.2.1 
G.2.1 
G.2.1 


4.2 
42 
4.2 


H.2 


2-30 


3-17 
3-18 
3-20 
3-18 
3-18 
3-24 
3-17 
3-20 
3-25 
3-19 
3-21 
3-22 
3-22 
3-20 
3-22 
3-20 
3-23 
3-18 


3-24 
3-24 








Term 


Disc files 
label processing 


Disc file-oriented address field 
Disc fixed-length records — sequential files 


Disc format 1 label 


Disc format 2 labels 
format 
function 


Disc format 3 labels 


Disc format 4 labels 
format 
function 


Disc format 5 labels 
format 
function 


Disc identification field 
Disc index areas 


Disc label 
checking for disc files 
creation for disc files 


Disc mapping program (DACMAP) 
Disc record types 


Disc space management 
data input 
imperative macros 
OBTAIN macro 
programming approach 
RENAME macro 
sample calculations, ISAM 
SCRTCH macro 


Disc space requirements for ISAM files 
basic calculations 
constraints on disc extents 
formulas 
higher level index 
introduction 
overflow area 
prime data cylinder capacity 
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Figure 2-22 2-34 
Figure 2-12 2-16 
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2.3.3 2-20 


2.3.4 2-24 


Figure 2-15 2—26 
2.3.5 2-26 


Figure 2-16 2-28 


2.3.6 2-28 
G.2.1 G-1 
4.2 4-31 
A.3.3 A-11 
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J.2.4 J-5 
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Term 


Disc user header/trailer labels 
format 
function 


Disc user volume label format 
Disc variable-length records — sequential files 


Disc volume labels 
disc user volume label format 
disc volume 1 label format 
discussion 
format 1 
format 2 
format 3 
format 4 
format 5 


Disc volume 1 label format 


DMCC routine contro! stream requirements 
explanation 
sample 


DMEAR macro 
DAM 
ISAM 
nonsequential file processing 


DM43 UU PUNCH error message 
DM46 uuu filename error message 


Document feed rate 
optical document reader 


Document format 


Document length (LGTH) 
optical document reader 


OTFCD 
instruction format 
1/0 modules 
keyword parameters 
transient routine names 


DTFDA macro 
data management dummy control 
section 
function 
1/0 modules 


Reference 


Page 


Figure 2-17 2—29 


2.3.7 


2-29 


Figure 2-11 2-15 


Figure 2-23 2-35 


Figure 2-11 2-15 
Figure 2-10 2—14 


2.3.1 
2.3.2 
2.3.3 
2.3.4 
2.3.5 
2.3.6 


2-31 
2-15 
2-20 
2-24 
2-26 
2-28 


Figure 2-10 2-14 


J.2.8 
3.2.8 


4.14 
4.2.3.5.5 
4.1.4 


J.3 


J.3 


1.5.1 

c.4 

Table B—3 
D4 


1.5 
4.1.1 
C.6 


J—20 
J-20 


4-30 
4-64 
4-30 
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Term 
keyword parameter summary 


transient routine names 


DTFIS 
file loading 
instruction format 
1/0 modules 
keyword parameters 
sequential processing 
transient routine names 


DTFIS fields addressable by user programs, 
ISAM 


DTFIS macro, summary of keyword parameters, 


ISAM 
DTFIS related dependent parameters, ISAM 


DTFMT 
discussion 
1/0 modules 
keyword parameters 


transient routine names 


DTFOR 
instruction format 
1/0 modules 
keyword parameters 
optical document reader, SFP 
transient routine names 


DTFPR 
instruction format 
1/0 modules 
keyword parameters 
transient routine names 


DTFPT 
instruction format 
1/0 modules 
transient routine names 


DTFSD 
instruction format 
1/0 modules 


keyword parameters 
transient routine names 
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Term 


Ellipsis 


End of an input file 
card device 


direct access storage devices 


End of cylinder 
DAM 


End-of-data (*job contro! statement) 


End of file 
address 
DAM 
ISAM 
label 
sentinel address 
sentinel size 


End-of-record character 
paper tape 


End of volume 
DAM 
label 


ENDFL macro, ISAM 
example 
format 
function 


EOF 
EOV 
Error bit settings, ISAM 


Error codes 
allocate routine 
console messages 
disc space management 
obtain routine 
rename routine 
scratch routine 


Error conditions, ISAM files 
initialization 
recoverable 
unrecoverable 
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Reference 


3.2.3 
3.2.2 


Table 4-1 


2.4.2 


3.2.5 
Table 4—1 
4.2.1 
2.2.2.1 
3.2.5 
3.2.5 


3.2.6 


Table 4—1 
2.2.2.1 


4.2.3.2.3 
4.2.3.2.3 
4.2.3.2.3 


2.2.1.4 
2.2.1.4 


Figure F—2 


§.5.1 
Table E-1 
5.5 

5.5.4 
5.5.3 
5.5.2 


F.1 
F.1 
F.1 
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3-30 
3-18 


3-49 
4-6 
4-36 
2-7 
3-49 
3-49 


3-65 


4-6 
2-7 


4-52 
4-51 
4-51 


2-7 


5-8 
E-2 
5-8 
5-11 
5-10 
5-10 


TTT 
-—- = = 
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Term 


Error field (filenameC), ISAM files 
bit settings, disc 
bit settings, random record 
processing 
introduction 
loading or extending a file 
unrecoverable error indicators 


Error messages 
data management common code 
DM43 UU PUNCH 
DM46 uuu filename 
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ERROR — INVALID CARD IN JOB 
STREAM — SCAN TERMINATED 


HERE 
ERROR — invalid parameter 


ERROR — PARAM MISSPELLED 


Error status codes 


ERROR — INVALID CARD IN JOB STREAM — 


SCAN TERMINATED HERE error 
message 


ERROR — invalid parameter error message 


ERROR — PARAM MISSPELLED error 
message 


ESETL macro 
examples 
format 
function 


Expanded 1/0 area, ISAM 
Expiration date field 
Extent 

Extent checking 


user island code 
user processing 


FE 


FEQOV common transient routine name 
DTFMT 
DTFSD 


Reference 


G.2.1 
Figure F~3 
F.2 

F.2.2 

F.2.1 

J.3 

J.3 

J.3 

J.3 

J.3 
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4.1.1 
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Term 


FEOV macro 
example 
format 
SFP 


File error, major 


File header label group 
format 
function 


File identifier not found 
rename routine error codes 


File loading, file reloading, and file 
extending macros, ISAM 
DTFIS macro 
function 
instruction usage 
SETFL macro 


File organization 
magnetic tape conventions 


File-oriented address field, disc 


File procedures, ‘SAM 
adding records 
introduction 
loading or extending 


random retrieval from an overflow 
area 

random retrieval on prime data 
track 

sequential retrieval starting with 
specified 1D 

sequential retrieval starting with 
specified key 


File processing type, ISAM 
File trailer label group 
EOF 
EOV 
functions 


File type, magnetic tape 


File updating 
direct access storage devices 
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Reference 


3.3.9 
3.3.9 
3.3.9 


See major 
file error 


Figure 2-3 
2.2.1.2 


D7 
4.2.3.2 
4.1.3 
4.2.3.2.1 


2.2.2 
G.2.1 
G.5.1 
G.5 


F.2.2 
Figure F—1 


2.2.1.4 
2.2.1.4 
2.2.1.4 


3.2.1 
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3-84 


3-84 


D-2 

4-48 
4-30 
4-48 


2-7 


3-24 





Term 
Filename 
Filename field addressing, ISAM 
Files 
First character control 
card device 
printer 
printer/punch 


punch recovery 


Fixed-length record format 


Flag byte 
Font/code relationship 


optical document reader 


Format labels, data input 
1 


om &w MN 


Formats for [{OA1 in main storage, 
schematic 


Forms handling information, printer 


Forms overflow punches, placing 
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Formulas for disc space requirements, ISAM 


basic calculations 

higher level index 

notes and conventions 

overflow area 

prime data cylinder capacity 
UNIVAC 8411/8414 differences 


FSN 


GET macro 
examples 


format 


function 
_ SFP 





Reference 


2.1 


3.2.3 
3.2.4 
2.4.3 
3.2.3 


3.2.5 
2.2.4.1 
Figure 2-8 


2.3.9 


3.2.5.1 
Table 3-10 


5.3.1 
5.3.1 
5.3.1 
5.3.1 
5.3.1 


Figure 4—1 
Appendix | 


Appendix | 


H.3.2 
H.3.4 
H.3.1 
H.3.5 
H.3.3 
Table H—1 


A.2.2 


4.2.3.5.2 
3.3.2 
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3-74 
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Term 


HDR1 format 

Head number, count area on disc 
Header label group, user 

Header labels, processing, user 


Header 1 label format 


Higher level index requirements, ISAM 


DAM 


READ macro 
WRITE macro 
write record 


Identification address 


Identifier, count area on disc 
cylinder number 
head number 
record number 


Ilegal 1D 
Image mode data flow 


Imperative macro instructions 
ALLOC 
basic macros 
CLOSE 


CNTRL 


DAM function 

disc space management 
FEOV 

format 

general function 

GET 

ISAM function 

LBRET 
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Reference 


Figure 2-3 
2.3.9 
2.2.1.3 
4.1.2.6 
Figure 2-3 


H.3.4 


4.1.1 
Table 4-2 
Table 4—2 
Table 4—2 
4.1.1 


See 1D 


2.3.9 
2.3.9 
2.3.9 


5.5.4 


Table 3-8 


5.4.1 
4.2.3.1 
3.3.8 
4.1.2.8 
3.3.6 
4.1.2.5 
4.1.2 
5.4 
3.3.9 
1.1.3 
1.1.3 
3.3.2 
4.2.3 
3.3.7 
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2-5 
2-32 
2-6 


4-27 


4-10 
4-11 
4-11 
4-11 
4-17 


2-33 
2-33 
2-33 
5-11 


3-53 


5-5 


4-46" 


3-83 
4—29 
3-78 
4-26 
4-20 
5—5 

3~84 
1-3 


3-74 
4-46 
3-80 


Term 


OBTAIN 
OPEN 


positional parameters 
PUT 

READ 

RELEX 

RELSE 

RENAME 
SCRTCH 

SFP 

trailing parameters 
TRUNC 

WAITF 

WRITE 


Index areas 
DAM 
disc 


Index requirements, higher level 
index search method, ISAM 
Indexed sequential access method 
Indexed sequential modules 


Indexes, ISAM file structure 
cylinder index 
introduction 
master index 
track index 


Input checks tape files 


Input files 
DAM 
direction, magnetic tape 
end, magnetic tape 
end, paper tape 
OPEN macro 
shifted code 


Input translation table card device 


Input/output 


Index 
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4.1.2.6 
5.4.4 
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4.2 
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Figure 4—3 
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G.3 
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A.2.4 
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Term 


Inserting records, ISAM files 
error bit settings 
bit 0 — unrecoverable device error 
bits 1 through 4 — unused 
bit 5 — duplicate key 
bit 6 — overflow area full 
bit 7 — unused 


Instruction format data management 
dummy control section 


Instruction usage 
adding records to existing file on 
unused track 
creating a sequential file 
deleting records on track within file 
reading a sequential or random file 
updating a sequential or random file 


Invalid file identifier 


Invalid ID, record not in specified 
extents 
DAM 


Invalid Parameter specification, allocate 
routine 


Invalid PUB or volume serial 
number 


tOAREAL area formats for loading or 
extending ISAM files 


10A1 in main storage, 
schematic of formats 


ISAM 

basic control structure 

basic macros 

blocking factor 

CLOSE macro 

close time 

current record pointer 

cylinder index in main storage 

cylinder overflow 

declarative macro 

device type 

disc areas 

DMEAR macro 

DTFIS related dependent 
parameters 
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Reference 


Figure F—2 
F.2.3 
F.2.3 
F.2.3 
F.2.3 
F.2.3 


1.5.1 


4.1.3 
4.1.3 
4.1.3 
4.1.3 
4.1.3 


Table 4—1 


5.5.1 


5.5.1 


Figure 4-7 


Figure 4—1 


4.2 
4.2.3.1 
4.2.1 
4.2.3.1.2 
4.2.1 
4.2.1 
4.2.1 
4.2.1 
42.1 
4.2.1 

4.2 
4.2.3.5.5 


Figure 4—4 
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4-30 
4-30 
4-30 
4-30 
4-30 


5-10 


4-6 


5-9 


4-51 


4-3 


4-31 
4—46 
4-40 
4-47 
4-35 
4-39 
4-37 
4-36 
4-32 
4-36 
4-31 
4-64 


4-34 






Term 


ENDFL macro 

end of file 

ESETL macro 

expanded 1/0 area 

file error conditions 

file loading, file reloading, 
and file extending macros 

file processing function 

file processing type 

filename field addressing 

functions 

GET macro 

imperative macros 

index search method, flow 
diagram 

IOAREAL area formats 

1/0 and work area requirements 

1/0 areas 

key length 

key location 

keyword parameters for DTFIS 
macro 

major file error 

master index 

OPEN macro 

overflow areas 

overflow record formats 

overflow records 

prime data record formats 

PUT macro 

random processing macro 

READ KEY macro 

record format 

record insertion macro 

record size 

retrieval search argument 

sequential processing macro 

SETFL macro 

SETL macro 

unblocked records 

verification requirements 

WAITF macro 

work area 

WRITE KEY macro 

WRITE NEWKEY macro 


ISAM file structure 
file procedures 
indexes 
overflow control 
space allocation 
VOL statement 
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4.2.3.2.3 
4.2.1 
4.2.3.5.4 
4.2.1 
Appendix F 


4.2.3.2 
4.2.1 
4.2.1 
4.2.2 

4.2 
4.2.3.5.2 
4.2.3 


Figure 4—3 
Figure 4—7 
Table 4-5 
4.2. 

4.2.1 

4.2.1 


Table 4—6 
4.2.1 

4.2.1 
4.2.3.1.1 
4.2 

Figure 4—6 
6.2.3 
Figure 4—5 
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G5 
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G.4 


A.3.1 
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Term 


1/0 
allocate routine 
scratch routine error codes 
work area requirements, 
ISAM files 


1/0 area 
card device 
contents for logical IOCS 
DAM 
direct access storage devices 
ISAM 
magnetic tape 
optical document reader 
Paper tape 
printer 


1/0 mode 
card device 
paper tape 


1/0 modules 
DTFDA 
DTFIS 
DTFMT 
DTFOR 
DTFPR 
DTFPT 
DTFSD 


Job control statements 
end-of-data (*) 
start-of-data ($) 


Key field 
DAM 


Key length 
count area on disc 
DAM 
ISAM 

Key location, SAM 


Key =1, ISAM 
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Reference 


5.5.1 
5.5.2 


Table 4—5 


3.2.3 
Table 4-3 
4.1.1. 
3.2.2. 
4.2.1 

3.2.1 

3.2.5 
3.2.6 
3.2.4 


3.2.3 
3.2.6 


2.4.2 
24.1 


2.3.9 
4.1.1. 
4.2.1 


G.5.1 
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4-38 


3-31 
4-32 
4-11 
3-20 
4-38 
3-6 

3-51 
3-67 
3-42 


3-31 
3-68 


ee 
c-4 
c-1 
c—4 
c-3 
C4 
c-2 


2-36 


ht 
| 


4—12 


2-33 
4-12 
4-39 


4-40 
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